Documentation ¶
Overview ¶
Package kmsinventory provides access to the KMS Inventory API.
For product documentation, see: https://cloud.google.com/kms/
Library status ¶
These client libraries are officially supported by Google. However, this library is considered complete and is in maintenance mode. This means that we will address critical bugs and security issues but will not add any new features.
When possible, we recommend using our newer [Cloud Client Libraries for Go](https://pkg.go.dev/cloud.google.com/go) that are still actively being worked and iterated on.
Creating a client ¶
Usage example:
import "google.golang.org/api/kmsinventory/v1" ... ctx := context.Background() kmsinventoryService, err := kmsinventory.NewService(ctx)
In this example, Google Application Default Credentials are used for authentication. For information on how to create and obtain Application Default Credentials, see https://developers.google.com/identity/protocols/application-default-credentials.
Other authentication options ¶
To use an API key for authentication (note: some APIs do not support API keys), use google.golang.org/api/option.WithAPIKey:
kmsinventoryService, err := kmsinventory.NewService(ctx, option.WithAPIKey("AIza..."))
To use an OAuth token (e.g., a user token obtained via a three-legged OAuth flow, use google.golang.org/api/option.WithTokenSource:
config := &oauth2.Config{...} // ... token, err := config.Exchange(ctx, ...) kmsinventoryService, err := kmsinventory.NewService(ctx, option.WithTokenSource(config.TokenSource(ctx, token)))
See google.golang.org/api/option.ClientOption for details on options.
Index ¶
- Constants
- type GoogleCloudKmsInventoryV1ListCryptoKeysResponse
- type GoogleCloudKmsInventoryV1ProtectedResource
- type GoogleCloudKmsInventoryV1ProtectedResourcesSummary
- type GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse
- type GoogleCloudKmsV1CryptoKey
- type GoogleCloudKmsV1CryptoKeyVersion
- type GoogleCloudKmsV1CryptoKeyVersionTemplate
- type GoogleCloudKmsV1ExternalProtectionLevelOptions
- type GoogleCloudKmsV1KeyOperationAttestation
- type GoogleCloudKmsV1KeyOperationAttestationCertificateChains
- type OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) Context(ctx context.Context) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) CryptoKey(cryptoKey string) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse, error)
- func (c *OrganizationsProtectedResourcesSearchCall) Fields(s ...googleapi.Field) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) Header() http.Header
- func (c *OrganizationsProtectedResourcesSearchCall) IfNoneMatch(entityTag string) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) PageSize(pageSize int64) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) PageToken(pageToken string) *OrganizationsProtectedResourcesSearchCall
- func (c *OrganizationsProtectedResourcesSearchCall) Pages(ctx context.Context, ...) error
- func (c *OrganizationsProtectedResourcesSearchCall) ResourceTypes(resourceTypes ...string) *OrganizationsProtectedResourcesSearchCall
- type OrganizationsProtectedResourcesService
- type OrganizationsService
- type ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) Context(ctx context.Context) *ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ListCryptoKeysResponse, error)
- func (c *ProjectsCryptoKeysListCall) Fields(s ...googleapi.Field) *ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) Header() http.Header
- func (c *ProjectsCryptoKeysListCall) IfNoneMatch(entityTag string) *ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) PageSize(pageSize int64) *ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) PageToken(pageToken string) *ProjectsCryptoKeysListCall
- func (c *ProjectsCryptoKeysListCall) Pages(ctx context.Context, ...) error
- type ProjectsCryptoKeysService
- type ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
- func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Context(ctx context.Context) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
- func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ProtectedResourcesSummary, error)
- func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Fields(s ...googleapi.Field) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
- func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Header() http.Header
- func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) IfNoneMatch(entityTag string) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
- type ProjectsLocationsKeyRingsCryptoKeysService
- type ProjectsLocationsKeyRingsService
- type ProjectsLocationsService
- type ProjectsService
- type Service
Constants ¶
const ( // See, edit, configure, and delete your Google Cloud data and see the // email address for your Google Account. CloudPlatformScope = "https://www.googleapis.com/auth/cloud-platform" )
OAuth2 scopes used by this API.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type GoogleCloudKmsInventoryV1ListCryptoKeysResponse ¶
type GoogleCloudKmsInventoryV1ListCryptoKeysResponse struct { // CryptoKeys: The list of CryptoKeys. CryptoKeys []*GoogleCloudKmsV1CryptoKey `json:"cryptoKeys,omitempty"` // NextPageToken: The page token returned from the previous response if // the next page is desired. NextPageToken string `json:"nextPageToken,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "CryptoKeys") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CryptoKeys") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsInventoryV1ListCryptoKeysResponse: Response message for KeyDashboardService.ListCryptoKeys.
func (*GoogleCloudKmsInventoryV1ListCryptoKeysResponse) MarshalJSON ¶
func (s *GoogleCloudKmsInventoryV1ListCryptoKeysResponse) MarshalJSON() ([]byte, error)
type GoogleCloudKmsInventoryV1ProtectedResource ¶
type GoogleCloudKmsInventoryV1ProtectedResource struct { // CloudProduct: The Cloud product that owns the resource. Example: // `compute` CloudProduct string `json:"cloudProduct,omitempty"` // CreateTime: Output only. The time at which this resource was created. // The granularity is in seconds. Timestamp.nanos will always be 0. CreateTime string `json:"createTime,omitempty"` // CryptoKeyVersion: The name of the Cloud KMS CryptoKeyVersion // (https://cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings.cryptoKeys.cryptoKeyVersions?hl=en) // used to protect this resource via CMEK. This field is empty if the // Google Cloud product owning the resource does not provide key version // data to Asset Inventory. If there are multiple key versions // protecting the resource, then this is same value as the first element // of crypto_key_versions. CryptoKeyVersion string `json:"cryptoKeyVersion,omitempty"` // CryptoKeyVersions: The names of the Cloud KMS CryptoKeyVersion // (https://cloud.google.com/kms/docs/reference/rest/v1/projects.locations.keyRings.cryptoKeys.cryptoKeyVersions?hl=en) // used to protect this resource via CMEK. This field is empty if the // Google Cloud product owning the resource does not provide key // versions data to Asset Inventory. The first element of this field is // stored in crypto_key_version. CryptoKeyVersions []string `json:"cryptoKeyVersions,omitempty"` // Labels: A key-value pair of the resource's labels (v1) to their // values. Labels map[string]string `json:"labels,omitempty"` // Location: Location can be `global`, regional like `us-east1`, or // zonal like `us-west1-b`. Location string `json:"location,omitempty"` // Name: The full resource name of the resource. Example: // `//compute.googleapis.com/projects/my_project_123/zones/zone1/instance // s/instance1`. Name string `json:"name,omitempty"` // Project: Format: `projects/{PROJECT_NUMBER}`. Project string `json:"project,omitempty"` // ProjectId: The ID of the project that owns the resource. ProjectId string `json:"projectId,omitempty"` // ResourceType: Example: `compute.googleapis.com/Disk` ResourceType string `json:"resourceType,omitempty"` // ForceSendFields is a list of field names (e.g. "CloudProduct") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CloudProduct") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsInventoryV1ProtectedResource: Metadata about a resource protected by a Cloud KMS key.
func (*GoogleCloudKmsInventoryV1ProtectedResource) MarshalJSON ¶
func (s *GoogleCloudKmsInventoryV1ProtectedResource) MarshalJSON() ([]byte, error)
type GoogleCloudKmsInventoryV1ProtectedResourcesSummary ¶
type GoogleCloudKmsInventoryV1ProtectedResourcesSummary struct { // CloudProducts: The number of resources protected by the key grouped // by Cloud product. CloudProducts map[string]string `json:"cloudProducts,omitempty"` // Locations: The number of resources protected by the key grouped by // region. Locations map[string]string `json:"locations,omitempty"` // Name: The full name of the ProtectedResourcesSummary resource. // Example: // projects/test-project/locations/us/keyRings/test-keyring/cryptoKeys/te // st-key/protectedResourcesSummary Name string `json:"name,omitempty"` // ProjectCount: The number of distinct Cloud projects in the same Cloud // organization as the key that have resources protected by the key. ProjectCount int64 `json:"projectCount,omitempty"` // ResourceCount: The total number of protected resources in the same // Cloud organization as the key. ResourceCount int64 `json:"resourceCount,omitempty,string"` // ResourceTypes: The number of resources protected by the key grouped // by resource type. ResourceTypes map[string]string `json:"resourceTypes,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "CloudProducts") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CloudProducts") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsInventoryV1ProtectedResourcesSummary: Aggregate information about the resources protected by a Cloud KMS key in the same Cloud organization as the key.
func (*GoogleCloudKmsInventoryV1ProtectedResourcesSummary) MarshalJSON ¶
func (s *GoogleCloudKmsInventoryV1ProtectedResourcesSummary) MarshalJSON() ([]byte, error)
type GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse ¶
type GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse struct { // NextPageToken: A token that can be sent as `page_token` to retrieve // the next page. If this field is omitted, there are no subsequent // pages. NextPageToken string `json:"nextPageToken,omitempty"` // ProtectedResources: Protected resources for this page. ProtectedResources []*GoogleCloudKmsInventoryV1ProtectedResource `json:"protectedResources,omitempty"` // ServerResponse contains the HTTP response code and headers from the // server. googleapi.ServerResponse `json:"-"` // ForceSendFields is a list of field names (e.g. "NextPageToken") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "NextPageToken") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse: Response message for KeyTrackingService.SearchProtectedResources.
func (*GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse) MarshalJSON ¶
func (s *GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1CryptoKey ¶
type GoogleCloudKmsV1CryptoKey struct { // CreateTime: Output only. The time at which this CryptoKey was // created. CreateTime string `json:"createTime,omitempty"` // CryptoKeyBackend: Immutable. The resource name of the backend // environment where the key material for all CryptoKeyVersions // associated with this CryptoKey reside and where all related // cryptographic operations are performed. Only applicable if // CryptoKeyVersions have a ProtectionLevel of EXTERNAL_VPC, with the // resource name in the format // `projects/*/locations/*/ekmConnections/*`. Note, this list is // non-exhaustive and may apply to additional ProtectionLevels in the // future. CryptoKeyBackend string `json:"cryptoKeyBackend,omitempty"` // DestroyScheduledDuration: Immutable. The period of time that versions // of this key spend in the DESTROY_SCHEDULED state before transitioning // to DESTROYED. If not specified at creation time, the default duration // is 24 hours. DestroyScheduledDuration string `json:"destroyScheduledDuration,omitempty"` // ImportOnly: Immutable. Whether this key may contain imported versions // only. ImportOnly bool `json:"importOnly,omitempty"` // Labels: Labels with user-defined metadata. For more information, see // Labeling Keys (https://cloud.google.com/kms/docs/labeling-keys). Labels map[string]string `json:"labels,omitempty"` // Name: Output only. The resource name for this CryptoKey in the format // `projects/*/locations/*/keyRings/*/cryptoKeys/*`. Name string `json:"name,omitempty"` // NextRotationTime: At next_rotation_time, the Key Management Service // will automatically: 1. Create a new version of this CryptoKey. 2. // Mark the new version as primary. Key rotations performed manually via // CreateCryptoKeyVersion and UpdateCryptoKeyPrimaryVersion do not // affect next_rotation_time. Keys with purpose ENCRYPT_DECRYPT support // automatic rotation. For other keys, this field must be omitted. NextRotationTime string `json:"nextRotationTime,omitempty"` // Primary: Output only. A copy of the "primary" CryptoKeyVersion that // will be used by Encrypt when this CryptoKey is given in // EncryptRequest.name. The CryptoKey's primary version can be updated // via UpdateCryptoKeyPrimaryVersion. Keys with purpose ENCRYPT_DECRYPT // may have a primary. For other keys, this field will be omitted. Primary *GoogleCloudKmsV1CryptoKeyVersion `json:"primary,omitempty"` // Purpose: Immutable. The immutable purpose of this CryptoKey. // // Possible values: // "CRYPTO_KEY_PURPOSE_UNSPECIFIED" - Not specified. // "ENCRYPT_DECRYPT" - CryptoKeys with this purpose may be used with // Encrypt and Decrypt. // "ASYMMETRIC_SIGN" - CryptoKeys with this purpose may be used with // AsymmetricSign and GetPublicKey. // "ASYMMETRIC_DECRYPT" - CryptoKeys with this purpose may be used // with AsymmetricDecrypt and GetPublicKey. // "RAW_ENCRYPT_DECRYPT" - CryptoKeys with this purpose may be used // with RawEncrypt and RawDecrypt. This purpose is meant to be used for // interoperable symmetric encryption and does not support automatic // CryptoKey rotation. // "MAC" - CryptoKeys with this purpose may be used with MacSign. Purpose string `json:"purpose,omitempty"` // RotationPeriod: next_rotation_time will be advanced by this period // when the service automatically rotates a key. Must be at least 24 // hours and at most 876,000 hours. If rotation_period is set, // next_rotation_time must also be set. Keys with purpose // ENCRYPT_DECRYPT support automatic rotation. For other keys, this // field must be omitted. RotationPeriod string `json:"rotationPeriod,omitempty"` // VersionTemplate: A template describing settings for new // CryptoKeyVersion instances. The properties of new CryptoKeyVersion // instances created by either CreateCryptoKeyVersion or auto-rotation // are controlled by this template. VersionTemplate *GoogleCloudKmsV1CryptoKeyVersionTemplate `json:"versionTemplate,omitempty"` // ForceSendFields is a list of field names (e.g. "CreateTime") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CreateTime") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1CryptoKey: A CryptoKey represents a logical key that can be used for cryptographic operations. A CryptoKey is made up of zero or more versions, which represent the actual key material used in cryptographic operations.
func (*GoogleCloudKmsV1CryptoKey) MarshalJSON ¶
func (s *GoogleCloudKmsV1CryptoKey) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1CryptoKeyVersion ¶
type GoogleCloudKmsV1CryptoKeyVersion struct { // Algorithm: Output only. The CryptoKeyVersionAlgorithm that this // CryptoKeyVersion supports. // // Possible values: // "CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED" - Not specified. // "GOOGLE_SYMMETRIC_ENCRYPTION" - Creates symmetric encryption keys. // "AES_128_GCM" - AES-GCM (Galois Counter Mode) using 128-bit keys. // "AES_256_GCM" - AES-GCM (Galois Counter Mode) using 256-bit keys. // "AES_128_CBC" - AES-CBC (Cipher Block Chaining Mode) using 128-bit // keys. // "AES_256_CBC" - AES-CBC (Cipher Block Chaining Mode) using 256-bit // keys. // "AES_128_CTR" - AES-CTR (Counter Mode) using 128-bit keys. // "AES_256_CTR" - AES-CTR (Counter Mode) using 256-bit keys. // "RSA_SIGN_PSS_2048_SHA256" - RSASSA-PSS 2048 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_3072_SHA256" - RSASSA-PSS 3072 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_4096_SHA256" - RSASSA-PSS 4096 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_4096_SHA512" - RSASSA-PSS 4096 bit key with a SHA512 // digest. // "RSA_SIGN_PKCS1_2048_SHA256" - RSASSA-PKCS1-v1_5 with a 2048 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_3072_SHA256" - RSASSA-PKCS1-v1_5 with a 3072 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_4096_SHA256" - RSASSA-PKCS1-v1_5 with a 4096 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_4096_SHA512" - RSASSA-PKCS1-v1_5 with a 4096 bit // key and a SHA512 digest. // "RSA_SIGN_RAW_PKCS1_2048" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 2048 bit key. // "RSA_SIGN_RAW_PKCS1_3072" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 3072 bit key. // "RSA_SIGN_RAW_PKCS1_4096" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 4096 bit key. // "RSA_DECRYPT_OAEP_2048_SHA256" - RSAES-OAEP 2048 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_3072_SHA256" - RSAES-OAEP 3072 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_4096_SHA256" - RSAES-OAEP 4096 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_4096_SHA512" - RSAES-OAEP 4096 bit key with a // SHA512 digest. // "RSA_DECRYPT_OAEP_2048_SHA1" - RSAES-OAEP 2048 bit key with a SHA1 // digest. // "RSA_DECRYPT_OAEP_3072_SHA1" - RSAES-OAEP 3072 bit key with a SHA1 // digest. // "RSA_DECRYPT_OAEP_4096_SHA1" - RSAES-OAEP 4096 bit key with a SHA1 // digest. // "EC_SIGN_P256_SHA256" - ECDSA on the NIST P-256 curve with a SHA256 // digest. Other hash functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "EC_SIGN_P384_SHA384" - ECDSA on the NIST P-384 curve with a SHA384 // digest. Other hash functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "EC_SIGN_SECP256K1_SHA256" - ECDSA on the non-NIST secp256k1 curve. // This curve is only supported for HSM protection level. Other hash // functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "HMAC_SHA256" - HMAC-SHA256 signing with a 256 bit key. // "HMAC_SHA1" - HMAC-SHA1 signing with a 160 bit key. // "HMAC_SHA384" - HMAC-SHA384 signing with a 384 bit key. // "HMAC_SHA512" - HMAC-SHA512 signing with a 512 bit key. // "HMAC_SHA224" - HMAC-SHA224 signing with a 224 bit key. // "EXTERNAL_SYMMETRIC_ENCRYPTION" - Algorithm representing symmetric // encryption by an external key manager. Algorithm string `json:"algorithm,omitempty"` // Attestation: Output only. Statement that was generated and signed by // the HSM at key creation time. Use this statement to verify attributes // of the key as stored on the HSM, independently of Google. Only // provided for key versions with protection_level HSM. Attestation *GoogleCloudKmsV1KeyOperationAttestation `json:"attestation,omitempty"` // CreateTime: Output only. The time at which this CryptoKeyVersion was // created. CreateTime string `json:"createTime,omitempty"` // DestroyEventTime: Output only. The time this CryptoKeyVersion's key // material was destroyed. Only present if state is DESTROYED. DestroyEventTime string `json:"destroyEventTime,omitempty"` // DestroyTime: Output only. The time this CryptoKeyVersion's key // material is scheduled for destruction. Only present if state is // DESTROY_SCHEDULED. DestroyTime string `json:"destroyTime,omitempty"` // ExternalDestructionFailureReason: Output only. The root cause of the // most recent external destruction failure. Only present if state is // EXTERNAL_DESTRUCTION_FAILED. ExternalDestructionFailureReason string `json:"externalDestructionFailureReason,omitempty"` // ExternalProtectionLevelOptions: ExternalProtectionLevelOptions stores // a group of additional fields for configuring a CryptoKeyVersion that // are specific to the EXTERNAL protection level and EXTERNAL_VPC // protection levels. ExternalProtectionLevelOptions *GoogleCloudKmsV1ExternalProtectionLevelOptions `json:"externalProtectionLevelOptions,omitempty"` // GenerateTime: Output only. The time this CryptoKeyVersion's key // material was generated. GenerateTime string `json:"generateTime,omitempty"` // GenerationFailureReason: Output only. The root cause of the most // recent generation failure. Only present if state is // GENERATION_FAILED. GenerationFailureReason string `json:"generationFailureReason,omitempty"` // ImportFailureReason: Output only. The root cause of the most recent // import failure. Only present if state is IMPORT_FAILED. ImportFailureReason string `json:"importFailureReason,omitempty"` // ImportJob: Output only. The name of the ImportJob used in the most // recent import of this CryptoKeyVersion. Only present if the // underlying key material was imported. ImportJob string `json:"importJob,omitempty"` // ImportTime: Output only. The time at which this CryptoKeyVersion's // key material was most recently imported. ImportTime string `json:"importTime,omitempty"` // Name: Output only. The resource name for this CryptoKeyVersion in the // format // `projects/*/locations/*/keyRings/*/cryptoKeys/*/cryptoKeyVersions/*`. Name string `json:"name,omitempty"` // ProtectionLevel: Output only. The ProtectionLevel describing how // crypto operations are performed with this CryptoKeyVersion. // // Possible values: // "PROTECTION_LEVEL_UNSPECIFIED" - Not specified. // "SOFTWARE" - Crypto operations are performed in software. // "HSM" - Crypto operations are performed in a Hardware Security // Module. // "EXTERNAL" - Crypto operations are performed by an external key // manager. // "EXTERNAL_VPC" - Crypto operations are performed in an EKM-over-VPC // backend. ProtectionLevel string `json:"protectionLevel,omitempty"` // ReimportEligible: Output only. Whether or not this key version is // eligible for reimport, by being specified as a target in // ImportCryptoKeyVersionRequest.crypto_key_version. ReimportEligible bool `json:"reimportEligible,omitempty"` // State: The current state of the CryptoKeyVersion. // // Possible values: // "CRYPTO_KEY_VERSION_STATE_UNSPECIFIED" - Not specified. // "PENDING_GENERATION" - This version is still being generated. It // may not be used, enabled, disabled, or destroyed yet. Cloud KMS will // automatically mark this version ENABLED as soon as the version is // ready. // "ENABLED" - This version may be used for cryptographic operations. // "DISABLED" - This version may not be used, but the key material is // still available, and the version can be placed back into the ENABLED // state. // "DESTROYED" - This version is destroyed, and the key material is no // longer stored. This version may only become ENABLED again if this // version is reimport_eligible and the original key material is // reimported with a call to // KeyManagementService.ImportCryptoKeyVersion. // "DESTROY_SCHEDULED" - This version is scheduled for destruction, // and will be destroyed soon. Call RestoreCryptoKeyVersion to put it // back into the DISABLED state. // "PENDING_IMPORT" - This version is still being imported. It may not // be used, enabled, disabled, or destroyed yet. Cloud KMS will // automatically mark this version ENABLED as soon as the version is // ready. // "IMPORT_FAILED" - This version was not imported successfully. It // may not be used, enabled, disabled, or destroyed. The submitted key // material has been discarded. Additional details can be found in // CryptoKeyVersion.import_failure_reason. // "GENERATION_FAILED" - This version was not generated successfully. // It may not be used, enabled, disabled, or destroyed. Additional // details can be found in CryptoKeyVersion.generation_failure_reason. // "PENDING_EXTERNAL_DESTRUCTION" - This version was destroyed, and it // may not be used or enabled again. Cloud KMS is waiting for the // corresponding key material residing in an external key manager to be // destroyed. // "EXTERNAL_DESTRUCTION_FAILED" - This version was destroyed, and it // may not be used or enabled again. However, Cloud KMS could not // confirm that the corresponding key material residing in an external // key manager was destroyed. Additional details can be found in // CryptoKeyVersion.external_destruction_failure_reason. State string `json:"state,omitempty"` // ForceSendFields is a list of field names (e.g. "Algorithm") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Algorithm") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1CryptoKeyVersion: A CryptoKeyVersion represents an individual cryptographic key, and the associated key material. An ENABLED version can be used for cryptographic operations. For security reasons, the raw cryptographic key material represented by a CryptoKeyVersion can never be viewed or exported. It can only be used to encrypt, decrypt, or sign data when an authorized user or application invokes Cloud KMS.
func (*GoogleCloudKmsV1CryptoKeyVersion) MarshalJSON ¶
func (s *GoogleCloudKmsV1CryptoKeyVersion) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1CryptoKeyVersionTemplate ¶
type GoogleCloudKmsV1CryptoKeyVersionTemplate struct { // Algorithm: Required. Algorithm to use when creating a // CryptoKeyVersion based on this template. For backwards compatibility, // GOOGLE_SYMMETRIC_ENCRYPTION is implied if both this field is omitted // and CryptoKey.purpose is ENCRYPT_DECRYPT. // // Possible values: // "CRYPTO_KEY_VERSION_ALGORITHM_UNSPECIFIED" - Not specified. // "GOOGLE_SYMMETRIC_ENCRYPTION" - Creates symmetric encryption keys. // "AES_128_GCM" - AES-GCM (Galois Counter Mode) using 128-bit keys. // "AES_256_GCM" - AES-GCM (Galois Counter Mode) using 256-bit keys. // "AES_128_CBC" - AES-CBC (Cipher Block Chaining Mode) using 128-bit // keys. // "AES_256_CBC" - AES-CBC (Cipher Block Chaining Mode) using 256-bit // keys. // "AES_128_CTR" - AES-CTR (Counter Mode) using 128-bit keys. // "AES_256_CTR" - AES-CTR (Counter Mode) using 256-bit keys. // "RSA_SIGN_PSS_2048_SHA256" - RSASSA-PSS 2048 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_3072_SHA256" - RSASSA-PSS 3072 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_4096_SHA256" - RSASSA-PSS 4096 bit key with a SHA256 // digest. // "RSA_SIGN_PSS_4096_SHA512" - RSASSA-PSS 4096 bit key with a SHA512 // digest. // "RSA_SIGN_PKCS1_2048_SHA256" - RSASSA-PKCS1-v1_5 with a 2048 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_3072_SHA256" - RSASSA-PKCS1-v1_5 with a 3072 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_4096_SHA256" - RSASSA-PKCS1-v1_5 with a 4096 bit // key and a SHA256 digest. // "RSA_SIGN_PKCS1_4096_SHA512" - RSASSA-PKCS1-v1_5 with a 4096 bit // key and a SHA512 digest. // "RSA_SIGN_RAW_PKCS1_2048" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 2048 bit key. // "RSA_SIGN_RAW_PKCS1_3072" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 3072 bit key. // "RSA_SIGN_RAW_PKCS1_4096" - RSASSA-PKCS1-v1_5 signing without // encoding, with a 4096 bit key. // "RSA_DECRYPT_OAEP_2048_SHA256" - RSAES-OAEP 2048 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_3072_SHA256" - RSAES-OAEP 3072 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_4096_SHA256" - RSAES-OAEP 4096 bit key with a // SHA256 digest. // "RSA_DECRYPT_OAEP_4096_SHA512" - RSAES-OAEP 4096 bit key with a // SHA512 digest. // "RSA_DECRYPT_OAEP_2048_SHA1" - RSAES-OAEP 2048 bit key with a SHA1 // digest. // "RSA_DECRYPT_OAEP_3072_SHA1" - RSAES-OAEP 3072 bit key with a SHA1 // digest. // "RSA_DECRYPT_OAEP_4096_SHA1" - RSAES-OAEP 4096 bit key with a SHA1 // digest. // "EC_SIGN_P256_SHA256" - ECDSA on the NIST P-256 curve with a SHA256 // digest. Other hash functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "EC_SIGN_P384_SHA384" - ECDSA on the NIST P-384 curve with a SHA384 // digest. Other hash functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "EC_SIGN_SECP256K1_SHA256" - ECDSA on the non-NIST secp256k1 curve. // This curve is only supported for HSM protection level. Other hash // functions can also be used: // https://cloud.google.com/kms/docs/create-validate-signatures#ecdsa_support_for_other_hash_algorithms // "HMAC_SHA256" - HMAC-SHA256 signing with a 256 bit key. // "HMAC_SHA1" - HMAC-SHA1 signing with a 160 bit key. // "HMAC_SHA384" - HMAC-SHA384 signing with a 384 bit key. // "HMAC_SHA512" - HMAC-SHA512 signing with a 512 bit key. // "HMAC_SHA224" - HMAC-SHA224 signing with a 224 bit key. // "EXTERNAL_SYMMETRIC_ENCRYPTION" - Algorithm representing symmetric // encryption by an external key manager. Algorithm string `json:"algorithm,omitempty"` // ProtectionLevel: ProtectionLevel to use when creating a // CryptoKeyVersion based on this template. Immutable. Defaults to // SOFTWARE. // // Possible values: // "PROTECTION_LEVEL_UNSPECIFIED" - Not specified. // "SOFTWARE" - Crypto operations are performed in software. // "HSM" - Crypto operations are performed in a Hardware Security // Module. // "EXTERNAL" - Crypto operations are performed by an external key // manager. // "EXTERNAL_VPC" - Crypto operations are performed in an EKM-over-VPC // backend. ProtectionLevel string `json:"protectionLevel,omitempty"` // ForceSendFields is a list of field names (e.g. "Algorithm") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "Algorithm") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1CryptoKeyVersionTemplate: A CryptoKeyVersionTemplate specifies the properties to use when creating a new CryptoKeyVersion, either manually with CreateCryptoKeyVersion or automatically as a result of auto-rotation.
func (*GoogleCloudKmsV1CryptoKeyVersionTemplate) MarshalJSON ¶
func (s *GoogleCloudKmsV1CryptoKeyVersionTemplate) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1ExternalProtectionLevelOptions ¶
type GoogleCloudKmsV1ExternalProtectionLevelOptions struct { // EkmConnectionKeyPath: The path to the external key material on the // EKM when using EkmConnection e.g., "v0/my/key". Set this field // instead of external_key_uri when using an EkmConnection. EkmConnectionKeyPath string `json:"ekmConnectionKeyPath,omitempty"` // ExternalKeyUri: The URI for an external resource that this // CryptoKeyVersion represents. ExternalKeyUri string `json:"externalKeyUri,omitempty"` // ForceSendFields is a list of field names (e.g. // "EkmConnectionKeyPath") to unconditionally include in API requests. // By default, fields with empty or default values are omitted from API // requests. However, any non-pointer, non-interface field appearing in // ForceSendFields will be sent to the server regardless of whether the // field is empty or not. This may be used to include empty fields in // Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "EkmConnectionKeyPath") to // include in API requests with the JSON null value. By default, fields // with empty values are omitted from API requests. However, any field // with an empty value appearing in NullFields will be sent to the // server as null. It is an error if a field in this list has a // non-empty value. This may be used to include null fields in Patch // requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1ExternalProtectionLevelOptions: ExternalProtectionLevelOptions stores a group of additional fields for configuring a CryptoKeyVersion that are specific to the EXTERNAL protection level and EXTERNAL_VPC protection levels.
func (*GoogleCloudKmsV1ExternalProtectionLevelOptions) MarshalJSON ¶
func (s *GoogleCloudKmsV1ExternalProtectionLevelOptions) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1KeyOperationAttestation ¶
type GoogleCloudKmsV1KeyOperationAttestation struct { // CertChains: Output only. The certificate chains needed to validate // the attestation CertChains *GoogleCloudKmsV1KeyOperationAttestationCertificateChains `json:"certChains,omitempty"` // Content: Output only. The attestation data provided by the HSM when // the key operation was performed. Content string `json:"content,omitempty"` // Format: Output only. The format of the attestation data. // // Possible values: // "ATTESTATION_FORMAT_UNSPECIFIED" - Not specified. // "CAVIUM_V1_COMPRESSED" - Cavium HSM attestation compressed with // gzip. Note that this format is defined by Cavium and subject to // change at any time. See // https://www.marvell.com/products/security-solutions/nitrox-hs-adapters/software-key-attestation.html. // "CAVIUM_V2_COMPRESSED" - Cavium HSM attestation V2 compressed with // gzip. This is a new format introduced in Cavium's version 3.2-08. Format string `json:"format,omitempty"` // ForceSendFields is a list of field names (e.g. "CertChains") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CertChains") to include in // API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. However, any field with an // empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1KeyOperationAttestation: Contains an HSM-generated attestation about a key operation. For more information, see [Verifying attestations] (https://cloud.google.com/kms/docs/attest-key).
func (*GoogleCloudKmsV1KeyOperationAttestation) MarshalJSON ¶
func (s *GoogleCloudKmsV1KeyOperationAttestation) MarshalJSON() ([]byte, error)
type GoogleCloudKmsV1KeyOperationAttestationCertificateChains ¶
type GoogleCloudKmsV1KeyOperationAttestationCertificateChains struct { // CaviumCerts: Cavium certificate chain corresponding to the // attestation. CaviumCerts []string `json:"caviumCerts,omitempty"` // GoogleCardCerts: Google card certificate chain corresponding to the // attestation. GoogleCardCerts []string `json:"googleCardCerts,omitempty"` // GooglePartitionCerts: Google partition certificate chain // corresponding to the attestation. GooglePartitionCerts []string `json:"googlePartitionCerts,omitempty"` // ForceSendFields is a list of field names (e.g. "CaviumCerts") to // unconditionally include in API requests. By default, fields with // empty or default values are omitted from API requests. However, any // non-pointer, non-interface field appearing in ForceSendFields will be // sent to the server regardless of whether the field is empty or not. // This may be used to include empty fields in Patch requests. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "CaviumCerts") to include // in API requests with the JSON null value. By default, fields with // empty values are omitted from API requests. However, any field with // an empty value appearing in NullFields will be sent to the server as // null. It is an error if a field in this list has a non-empty value. // This may be used to include null fields in Patch requests. NullFields []string `json:"-"` }
GoogleCloudKmsV1KeyOperationAttestationCertificateChains: Certificate chains needed to verify the attestation. Certificates in chains are PEM-encoded and are ordered based on https://tools.ietf.org/html/rfc5246#section-7.4.2.
func (*GoogleCloudKmsV1KeyOperationAttestationCertificateChains) MarshalJSON ¶
func (s *GoogleCloudKmsV1KeyOperationAttestationCertificateChains) MarshalJSON() ([]byte, error)
type OrganizationsProtectedResourcesSearchCall ¶
type OrganizationsProtectedResourcesSearchCall struct {
// contains filtered or unexported fields
}
func (*OrganizationsProtectedResourcesSearchCall) Context ¶
func (c *OrganizationsProtectedResourcesSearchCall) Context(ctx context.Context) *OrganizationsProtectedResourcesSearchCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*OrganizationsProtectedResourcesSearchCall) CryptoKey ¶
func (c *OrganizationsProtectedResourcesSearchCall) CryptoKey(cryptoKey string) *OrganizationsProtectedResourcesSearchCall
CryptoKey sets the optional parameter "cryptoKey": Required. The resource name of the CryptoKey.
func (*OrganizationsProtectedResourcesSearchCall) Do ¶
func (c *OrganizationsProtectedResourcesSearchCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse, error)
Do executes the "kmsinventory.organizations.protectedResources.search" call. Exactly one of *GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse.ServerRespo nse.Header or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*OrganizationsProtectedResourcesSearchCall) Fields ¶
func (c *OrganizationsProtectedResourcesSearchCall) Fields(s ...googleapi.Field) *OrganizationsProtectedResourcesSearchCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*OrganizationsProtectedResourcesSearchCall) Header ¶
func (c *OrganizationsProtectedResourcesSearchCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*OrganizationsProtectedResourcesSearchCall) IfNoneMatch ¶
func (c *OrganizationsProtectedResourcesSearchCall) IfNoneMatch(entityTag string) *OrganizationsProtectedResourcesSearchCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (*OrganizationsProtectedResourcesSearchCall) PageSize ¶
func (c *OrganizationsProtectedResourcesSearchCall) PageSize(pageSize int64) *OrganizationsProtectedResourcesSearchCall
PageSize sets the optional parameter "pageSize": The maximum number of resources to return. The service may return fewer than this value. If unspecified, at most 500 resources will be returned. The maximum value is 500; values above 500 will be coerced to 500.
func (*OrganizationsProtectedResourcesSearchCall) PageToken ¶
func (c *OrganizationsProtectedResourcesSearchCall) PageToken(pageToken string) *OrganizationsProtectedResourcesSearchCall
PageToken sets the optional parameter "pageToken": A page token, received from a previous KeyTrackingService.SearchProtectedResources call. Provide this to retrieve the subsequent page. When paginating, all other parameters provided to KeyTrackingService.SearchProtectedResources must match the call that provided the page token.
func (*OrganizationsProtectedResourcesSearchCall) Pages ¶
func (c *OrganizationsProtectedResourcesSearchCall) Pages(ctx context.Context, f func(*GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
func (*OrganizationsProtectedResourcesSearchCall) ResourceTypes ¶ added in v0.131.0
func (c *OrganizationsProtectedResourcesSearchCall) ResourceTypes(resourceTypes ...string) *OrganizationsProtectedResourcesSearchCall
ResourceTypes sets the optional parameter "resourceTypes": A list of resource types that this request searches for. If empty, it will search all the trackable resource types (https://cloud.google.com/kms/docs/view-key-usage#tracked-resource-types). Regular expressions are also supported. For example: * `compute.googleapis.com.*` snapshots resources whose type starts with `compute.googleapis.com`. * `.*Image` snapshots resources whose type ends with `Image`. * `.*Image.*` snapshots resources whose type contains `Image`. See RE2 (https://github.com/google/re2/wiki/Syntax) for all supported regular expression syntax. If the regular expression does not match any supported resource type, an INVALID_ARGUMENT error will be returned.
type OrganizationsProtectedResourcesService ¶
type OrganizationsProtectedResourcesService struct {
// contains filtered or unexported fields
}
func NewOrganizationsProtectedResourcesService ¶
func NewOrganizationsProtectedResourcesService(s *Service) *OrganizationsProtectedResourcesService
func (*OrganizationsProtectedResourcesService) Search ¶
func (r *OrganizationsProtectedResourcesService) Search(scope string) *OrganizationsProtectedResourcesSearchCall
Search: Returns metadata about the resources protected by the given Cloud KMS CryptoKey in the given Cloud organization.
- scope: Resource name of the organization. Example: organizations/123.
type OrganizationsService ¶
type OrganizationsService struct { ProtectedResources *OrganizationsProtectedResourcesService // contains filtered or unexported fields }
func NewOrganizationsService ¶
func NewOrganizationsService(s *Service) *OrganizationsService
type ProjectsCryptoKeysListCall ¶
type ProjectsCryptoKeysListCall struct {
// contains filtered or unexported fields
}
func (*ProjectsCryptoKeysListCall) Context ¶
func (c *ProjectsCryptoKeysListCall) Context(ctx context.Context) *ProjectsCryptoKeysListCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsCryptoKeysListCall) Do ¶
func (c *ProjectsCryptoKeysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ListCryptoKeysResponse, error)
Do executes the "kmsinventory.projects.cryptoKeys.list" call. Exactly one of *GoogleCloudKmsInventoryV1ListCryptoKeysResponse or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudKmsInventoryV1ListCryptoKeysResponse.ServerResponse.Header
or (if a response was returned at all) in
error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsCryptoKeysListCall) Fields ¶
func (c *ProjectsCryptoKeysListCall) Fields(s ...googleapi.Field) *ProjectsCryptoKeysListCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsCryptoKeysListCall) Header ¶
func (c *ProjectsCryptoKeysListCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsCryptoKeysListCall) IfNoneMatch ¶
func (c *ProjectsCryptoKeysListCall) IfNoneMatch(entityTag string) *ProjectsCryptoKeysListCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
func (*ProjectsCryptoKeysListCall) PageSize ¶
func (c *ProjectsCryptoKeysListCall) PageSize(pageSize int64) *ProjectsCryptoKeysListCall
PageSize sets the optional parameter "pageSize": The maximum number of keys to return. The service may return fewer than this value. If unspecified, at most 1000 keys will be returned. The maximum value is 1000; values above 1000 will be coerced to 1000.
func (*ProjectsCryptoKeysListCall) PageToken ¶
func (c *ProjectsCryptoKeysListCall) PageToken(pageToken string) *ProjectsCryptoKeysListCall
PageToken sets the optional parameter "pageToken": Pass this into a subsequent request in order to receive the next page of results.
func (*ProjectsCryptoKeysListCall) Pages ¶
func (c *ProjectsCryptoKeysListCall) Pages(ctx context.Context, f func(*GoogleCloudKmsInventoryV1ListCryptoKeysResponse) error) error
Pages invokes f for each page of results. A non-nil error returned from f will halt the iteration. The provided context supersedes any context provided to the Context method.
type ProjectsCryptoKeysService ¶
type ProjectsCryptoKeysService struct {
// contains filtered or unexported fields
}
func NewProjectsCryptoKeysService ¶
func NewProjectsCryptoKeysService(s *Service) *ProjectsCryptoKeysService
func (*ProjectsCryptoKeysService) List ¶
func (r *ProjectsCryptoKeysService) List(parent string) *ProjectsCryptoKeysListCall
List: Returns cryptographic keys managed by Cloud KMS in a given Cloud project. Note that this data is sourced from snapshots, meaning it may not completely reflect the actual state of key metadata at call time.
- parent: The Google Cloud project for which to retrieve key metadata, in the format `projects/*`.
type ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall ¶
type ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall struct {
// contains filtered or unexported fields
}
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Context ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Context(ctx context.Context) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
Context sets the context to be used in this call's Do method. Any pending HTTP request will be aborted if the provided context is canceled.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Do ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ProtectedResourcesSummary, error)
Do executes the "kmsinventory.projects.locations.keyRings.cryptoKeys.getProtectedResourcesSummary" call. Exactly one of *GoogleCloudKmsInventoryV1ProtectedResourcesSummary or error will be non-nil. Any non-2xx status code is an error. Response headers are in either *GoogleCloudKmsInventoryV1ProtectedResourcesSummary.ServerResponse.Hea der or (if a response was returned at all) in error.(*googleapi.Error).Header. Use googleapi.IsNotModified to check whether the returned error was because http.StatusNotModified was returned.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Fields ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Fields(s ...googleapi.Field) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
Fields allows partial responses to be retrieved. See https://developers.google.com/gdata/docs/2.0/basics#PartialResponse for more information.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Header ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Header() http.Header
Header returns an http.Header that can be modified by the caller to add HTTP headers to the request.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) IfNoneMatch ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) IfNoneMatch(entityTag string) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
IfNoneMatch sets the optional parameter which makes the operation fail if the object's ETag matches the given value. This is useful for getting updates only after the object has changed since the last request. Use googleapi.IsNotModified to check whether the response error from Do is the result of In-None-Match.
type ProjectsLocationsKeyRingsCryptoKeysService ¶
type ProjectsLocationsKeyRingsCryptoKeysService struct {
// contains filtered or unexported fields
}
func NewProjectsLocationsKeyRingsCryptoKeysService ¶
func NewProjectsLocationsKeyRingsCryptoKeysService(s *Service) *ProjectsLocationsKeyRingsCryptoKeysService
func (*ProjectsLocationsKeyRingsCryptoKeysService) GetProtectedResourcesSummary ¶
func (r *ProjectsLocationsKeyRingsCryptoKeysService) GetProtectedResourcesSummary(name string) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
GetProtectedResourcesSummary: Returns aggregate information about the resources protected by the given Cloud KMS CryptoKey. Only resources within the same Cloud organization as the key will be returned. The project that holds the key must be part of an organization in order for this call to succeed.
- name: The resource name of the CryptoKey.
type ProjectsLocationsKeyRingsService ¶
type ProjectsLocationsKeyRingsService struct { CryptoKeys *ProjectsLocationsKeyRingsCryptoKeysService // contains filtered or unexported fields }
func NewProjectsLocationsKeyRingsService ¶
func NewProjectsLocationsKeyRingsService(s *Service) *ProjectsLocationsKeyRingsService
type ProjectsLocationsService ¶
type ProjectsLocationsService struct { KeyRings *ProjectsLocationsKeyRingsService // contains filtered or unexported fields }
func NewProjectsLocationsService ¶
func NewProjectsLocationsService(s *Service) *ProjectsLocationsService
type ProjectsService ¶
type ProjectsService struct { CryptoKeys *ProjectsCryptoKeysService Locations *ProjectsLocationsService // contains filtered or unexported fields }
func NewProjectsService ¶
func NewProjectsService(s *Service) *ProjectsService
type Service ¶
type Service struct { BasePath string // API endpoint base URL UserAgent string // optional additional User-Agent fragment Organizations *OrganizationsService Projects *ProjectsService // contains filtered or unexported fields }
func New
deprecated
New creates a new Service. It uses the provided http.Client for requests.
Deprecated: please use NewService instead. To provide a custom HTTP client, use option.WithHTTPClient. If you are using google.golang.org/api/googleapis/transport.APIKey, use option.WithAPIKey with NewService instead.
func NewService ¶
NewService creates a new Service.