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 GoogleCloudKmsV1KeyAccessJustificationsPolicy
- 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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/instances/insta // nce1`. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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/test-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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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 30 // days. DestroyScheduledDuration string `json:"destroyScheduledDuration,omitempty"` // ImportOnly: Immutable. Whether this key may contain imported versions only. ImportOnly bool `json:"importOnly,omitempty"` // KeyAccessJustificationsPolicy: Optional. The policy used for Key Access // Justifications Policy Enforcement. If this field is present and this key is // enrolled in Key Access Justifications Policy Enforcement, the policy will be // evaluated in encrypt, decrypt, and sign operations, and the operation will // fail if rejected by the policy. The policy is defined by specifying zero or // more allowed justification codes. // https://cloud.google.com/assured-workloads/key-access-justifications/docs/justification-codes // By default, this field is absent, and all justification codes are allowed. KeyAccessJustificationsPolicy *GoogleCloudKmsV1KeyAccessJustificationsPolicy `json:"keyAccessJustificationsPolicy,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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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 // "EC_SIGN_ED25519" - EdDSA on the Curve25519 in pure mode (taking data as // input). // "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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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 // "EC_SIGN_ED25519" - EdDSA on the Curve25519 in pure mode (taking data as // input). // "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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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 GoogleCloudKmsV1KeyAccessJustificationsPolicy ¶ added in v0.186.0
type GoogleCloudKmsV1KeyAccessJustificationsPolicy struct { // AllowedAccessReasons: The list of allowed reasons for access to a CryptoKey. // Zero allowed access reasons means all encrypt, decrypt, and sign operations // for the CryptoKey associated with this policy will fail. // // Possible values: // "REASON_UNSPECIFIED" - Unspecified access reason. // "CUSTOMER_INITIATED_SUPPORT" - Customer-initiated support. // "GOOGLE_INITIATED_SERVICE" - Google-initiated access for system management // and troubleshooting. // "THIRD_PARTY_DATA_REQUEST" - Google-initiated access in response to a // legal request or legal process. // "GOOGLE_INITIATED_REVIEW" - Google-initiated access for security, fraud, // abuse, or compliance purposes. // "CUSTOMER_INITIATED_ACCESS" - Customer uses their account to perform any // access to their own data which their IAM policy authorizes. // "GOOGLE_INITIATED_SYSTEM_OPERATION" - Google systems access customer data // to help optimize the structure of the data or quality for future uses by the // customer. // "REASON_NOT_EXPECTED" - No reason is expected for this key request. // "MODIFIED_CUSTOMER_INITIATED_ACCESS" - Customer uses their account to // perform any access to their own data which their IAM policy authorizes, and // one of the following is true: * A Google administrator has reset the // root-access account associated with the user's organization within the past // 7 days. * A Google-initiated emergency access operation has interacted with // a resource in the same project or folder as the currently accessed resource // within the past 7 days. // "MODIFIED_GOOGLE_INITIATED_SYSTEM_OPERATION" - Google systems access // customer data to help optimize the structure of the data or quality for // future uses by the customer, and one of the following is true: * A Google // administrator has reset the root-access account associated with the user's // organization within the past 7 days. * A Google-initiated emergency access // operation has interacted with a resource in the same project or folder as // the currently accessed resource within the past 7 days. // "GOOGLE_RESPONSE_TO_PRODUCTION_ALERT" - Google-initiated access to // maintain system reliability. // "CUSTOMER_AUTHORIZED_WORKFLOW_SERVICING" - One of the following operations // is being executed while simultaneously encountering an internal technical // issue which prevented a more precise justification code from being // generated: * Your account has been used to perform any access to your own // data which your IAM policy authorizes. * An automated Google system operates // on encrypted customer data which your IAM policy authorizes. * // Customer-initiated Google support access. * Google-initiated support access // to protect system reliability. AllowedAccessReasons []string `json:"allowedAccessReasons,omitempty"` // ForceSendFields is a list of field names (e.g. "AllowedAccessReasons") to // unconditionally include in API requests. By default, fields with empty or // default values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. ForceSendFields []string `json:"-"` // NullFields is a list of field names (e.g. "AllowedAccessReasons") to include // in API requests with the JSON null value. By default, fields with empty // values are omitted from API requests. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. NullFields []string `json:"-"` }
GoogleCloudKmsV1KeyAccessJustificationsPolicy: A KeyAccessJustificationsPolicy specifies zero or more allowed AccessReason values for encrypt, decrypt, and sign operations on a CryptoKey.
func (GoogleCloudKmsV1KeyAccessJustificationsPolicy) MarshalJSON ¶ added in v0.186.0
func (s GoogleCloudKmsV1KeyAccessJustificationsPolicy) 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-ForceSendFields for more // details. 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. See // https://pkg.go.dev/google.golang.org/api#hdr-NullFields for more details. 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.
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. Any non-2xx status code is an error. Response headers are in either *GoogleCloudKmsInventoryV1SearchProtectedResourcesResponse.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 (*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 details.
func (*OrganizationsProtectedResourcesSearchCall) Header ¶
func (c *OrganizationsProtectedResourcesSearchCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (*OrganizationsProtectedResourcesSearchCall) IfNoneMatch ¶
func (c *OrganizationsProtectedResourcesSearchCall) IfNoneMatch(entityTag string) *OrganizationsProtectedResourcesSearchCall
IfNoneMatch sets an 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.
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.
func (*ProjectsCryptoKeysListCall) Do ¶
func (c *ProjectsCryptoKeysListCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ListCryptoKeysResponse, error)
Do executes the "kmsinventory.projects.cryptoKeys.list" call. 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 details.
func (*ProjectsCryptoKeysListCall) Header ¶
func (c *ProjectsCryptoKeysListCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (*ProjectsCryptoKeysListCall) IfNoneMatch ¶
func (c *ProjectsCryptoKeysListCall) IfNoneMatch(entityTag string) *ProjectsCryptoKeysListCall
IfNoneMatch sets an 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.
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.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Do ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Do(opts ...googleapi.CallOption) (*GoogleCloudKmsInventoryV1ProtectedResourcesSummary, error)
Do executes the "kmsinventory.projects.locations.keyRings.cryptoKeys.getProtectedResourcesSummary" call. Any non-2xx status code is an error. Response headers are in either *GoogleCloudKmsInventoryV1ProtectedResourcesSummary.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 (*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 details.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Header ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) Header() http.Header
Header returns a http.Header that can be modified by the caller to add headers to the request.
func (*ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) IfNoneMatch ¶
func (c *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall) IfNoneMatch(entityTag string) *ProjectsLocationsKeyRingsCryptoKeysGetProtectedResourcesSummaryCall
IfNoneMatch sets an 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.
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.