/AWS1/CL_MA2MATCHINGBUCKET¶
Provides statistical data and other information about an S3 bucket that Amazon Macie monitors and analyzes for your account. By default, object count and storage size values include data for object parts that are the result of incomplete multipart uploads. For more information, see How Macie monitors Amazon S3 data security in the Amazon Macie User Guide.
If an error or issue prevents Macie from retrieving and processing information about the bucket or the bucket's objects, the value for many of these properties is null. Key exceptions are accountId and bucketName. To identify the cause, refer to the errorCode and errorMessage values.
CONSTRUCTOR¶
IMPORTING¶
Optional arguments:¶
iv_accountid TYPE /AWS1/MA2__STRING /AWS1/MA2__STRING¶
The unique identifier for the Amazon Web Services account that owns the bucket.
iv_automateddiscoverymonstat TYPE /AWS1/MA2AUTOMATEDDISCOVERYM00 /AWS1/MA2AUTOMATEDDISCOVERYM00¶
Specifies whether automated sensitive data discovery is currently configured to analyze objects in the bucket. Possible values are: MONITORED, the bucket is included in analyses; and, NOT_MONITORED, the bucket is excluded from analyses. If automated sensitive data discovery is disabled for your account, this value is NOT_MONITORED.
iv_bucketname TYPE /AWS1/MA2__STRING /AWS1/MA2__STRING¶
The name of the bucket.
iv_classifiableobjectcount TYPE /AWS1/MA2__LONG /AWS1/MA2__LONG¶
The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.
iv_classifiablesizeinbytes TYPE /AWS1/MA2__LONG /AWS1/MA2__LONG¶
The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.
If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.
iv_errorcode TYPE /AWS1/MA2BUCKETMETERRORCODE /AWS1/MA2BUCKETMETERRORCODE¶
The code for an error or issue that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. Possible values are:
ACCESS_DENIED - Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request.
BUCKET_COUNT_EXCEEDS_QUOTA - Retrieving and processing the information would exceed the quota for the number of buckets that Macie monitors for an account (10,000).
If this value is null, Macie was able to retrieve and process the information.
iv_errormessage TYPE /AWS1/MA2__STRING /AWS1/MA2__STRING¶
A brief description of the error or issue (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.
io_jobdetails TYPE REF TO /AWS1/CL_MA2JOBDETAILS /AWS1/CL_MA2JOBDETAILS¶
Specifies whether any one-time or recurring classification jobs are configured to analyze objects in the bucket, and, if so, the details of the job that ran most recently.
iv_lastautomateddiscoveryt00 TYPE /AWS1/MA2__TIMESTAMPISO8601 /AWS1/MA2__TIMESTAMPISO8601¶
The date and time, in UTC and extended ISO 8601 format, when Amazon Macie most recently analyzed objects in the bucket while performing automated sensitive data discovery. This value is null if this analysis hasn't occurred.
iv_objectcount TYPE /AWS1/MA2__LONG /AWS1/MA2__LONG¶
The total number of objects in the bucket.
io_objectcountbyenctype TYPE REF TO /AWS1/CL_MA2OBJCOUNTBYENCTYPE /AWS1/CL_MA2OBJCOUNTBYENCTYPE¶
The total number of objects in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.
iv_sensitivityscore TYPE /AWS1/MA2__INTEGER /AWS1/MA2__INTEGER¶
The sensitivity score for the bucket, ranging from -1 (classification error) to 100 (sensitive).
If automated sensitive data discovery has never been enabled for your account or it's been disabled for your organization or standalone account for more than 30 days, possible values are: 1, the bucket is empty; or, 50, the bucket stores objects but it's been excluded from recent analyses.
iv_sizeinbytes TYPE /AWS1/MA2__LONG /AWS1/MA2__LONG¶
The total storage size, in bytes, of the bucket.
If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.
iv_sizeinbytescompressed TYPE /AWS1/MA2__LONG /AWS1/MA2__LONG¶
The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.
If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.
io_unclassifiableobjectcount TYPE REF TO /AWS1/CL_MA2OBJECTLEVELSTATS /AWS1/CL_MA2OBJECTLEVELSTATS¶
The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.
io_unclifiableobjsizeinbytes TYPE REF TO /AWS1/CL_MA2OBJECTLEVELSTATS /AWS1/CL_MA2OBJECTLEVELSTATS¶
The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.
Queryable Attributes¶
accountId¶
The unique identifier for the Amazon Web Services account that owns the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ACCOUNTID() |
Getter for ACCOUNTID, with configurable default |
ASK_ACCOUNTID() |
Getter for ACCOUNTID w/ exceptions if field has no value |
HAS_ACCOUNTID() |
Determine if ACCOUNTID has a value |
automatedDiscoveryMonitoringStatus¶
Specifies whether automated sensitive data discovery is currently configured to analyze objects in the bucket. Possible values are: MONITORED, the bucket is included in analyses; and, NOT_MONITORED, the bucket is excluded from analyses. If automated sensitive data discovery is disabled for your account, this value is NOT_MONITORED.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_AUTOMATEDDISCOVERYMONS00() |
Getter for AUTOMATEDDISCOVERYMONSTATUS, with configurable de |
ASK_AUTOMATEDDISCOVERYMONS00() |
Getter for AUTOMATEDDISCOVERYMONSTATUS w/ exceptions if fiel |
HAS_AUTOMATEDDISCOVERYMONS00() |
Determine if AUTOMATEDDISCOVERYMONSTATUS has a value |
bucketName¶
The name of the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_BUCKETNAME() |
Getter for BUCKETNAME, with configurable default |
ASK_BUCKETNAME() |
Getter for BUCKETNAME w/ exceptions if field has no value |
HAS_BUCKETNAME() |
Determine if BUCKETNAME has a value |
classifiableObjectCount¶
The total number of objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CLASSIFIABLEOBJECTCOUNT() |
Getter for CLASSIFIABLEOBJECTCOUNT, with configurable defaul |
ASK_CLASSIFIABLEOBJECTCOUNT() |
Getter for CLASSIFIABLEOBJECTCOUNT w/ exceptions if field ha |
HAS_CLASSIFIABLEOBJECTCOUNT() |
Determine if CLASSIFIABLEOBJECTCOUNT has a value |
classifiableSizeInBytes¶
The total storage size, in bytes, of the objects that Amazon Macie can analyze in the bucket. These objects use a supported storage class and have a file name extension for a supported file or storage format.
If versioning is enabled for the bucket, Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_CLASSIFIABLESIZEINBYTES() |
Getter for CLASSIFIABLESIZEINBYTES, with configurable defaul |
ASK_CLASSIFIABLESIZEINBYTES() |
Getter for CLASSIFIABLESIZEINBYTES w/ exceptions if field ha |
HAS_CLASSIFIABLESIZEINBYTES() |
Determine if CLASSIFIABLESIZEINBYTES has a value |
errorCode¶
The code for an error or issue that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. Possible values are:
ACCESS_DENIED - Macie doesn't have permission to retrieve the information. For example, the bucket has a restrictive bucket policy and Amazon S3 denied the request.
BUCKET_COUNT_EXCEEDS_QUOTA - Retrieving and processing the information would exceed the quota for the number of buckets that Macie monitors for an account (10,000).
If this value is null, Macie was able to retrieve and process the information.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ERRORCODE() |
Getter for ERRORCODE, with configurable default |
ASK_ERRORCODE() |
Getter for ERRORCODE w/ exceptions if field has no value |
HAS_ERRORCODE() |
Determine if ERRORCODE has a value |
errorMessage¶
A brief description of the error or issue (errorCode) that prevented Amazon Macie from retrieving and processing information about the bucket and the bucket's objects. This value is null if Macie was able to retrieve and process the information.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_ERRORMESSAGE() |
Getter for ERRORMESSAGE, with configurable default |
ASK_ERRORMESSAGE() |
Getter for ERRORMESSAGE w/ exceptions if field has no value |
HAS_ERRORMESSAGE() |
Determine if ERRORMESSAGE has a value |
jobDetails¶
Specifies whether any one-time or recurring classification jobs are configured to analyze objects in the bucket, and, if so, the details of the job that ran most recently.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_JOBDETAILS() |
Getter for JOBDETAILS |
lastAutomatedDiscoveryTime¶
The date and time, in UTC and extended ISO 8601 format, when Amazon Macie most recently analyzed objects in the bucket while performing automated sensitive data discovery. This value is null if this analysis hasn't occurred.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_LASTAUTOMATEDDISCOVERY00() |
Getter for LASTAUTOMATEDDISCOVERYTIME, with configurable def |
ASK_LASTAUTOMATEDDISCOVERY00() |
Getter for LASTAUTOMATEDDISCOVERYTIME w/ exceptions if field |
HAS_LASTAUTOMATEDDISCOVERY00() |
Determine if LASTAUTOMATEDDISCOVERYTIME has a value |
objectCount¶
The total number of objects in the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_OBJECTCOUNT() |
Getter for OBJECTCOUNT, with configurable default |
ASK_OBJECTCOUNT() |
Getter for OBJECTCOUNT w/ exceptions if field has no value |
HAS_OBJECTCOUNT() |
Determine if OBJECTCOUNT has a value |
objectCountByEncryptionType¶
The total number of objects in the bucket, grouped by server-side encryption type. This includes a grouping that reports the total number of objects that aren't encrypted or use client-side encryption.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_OBJECTCOUNTBYENCTYPE() |
Getter for OBJECTCOUNTBYENCRYPTIONTYPE |
sensitivityScore¶
The sensitivity score for the bucket, ranging from -1 (classification error) to 100 (sensitive).
If automated sensitive data discovery has never been enabled for your account or it's been disabled for your organization or standalone account for more than 30 days, possible values are: 1, the bucket is empty; or, 50, the bucket stores objects but it's been excluded from recent analyses.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SENSITIVITYSCORE() |
Getter for SENSITIVITYSCORE, with configurable default |
ASK_SENSITIVITYSCORE() |
Getter for SENSITIVITYSCORE w/ exceptions if field has no va |
HAS_SENSITIVITYSCORE() |
Determine if SENSITIVITYSCORE has a value |
sizeInBytes¶
The total storage size, in bytes, of the bucket.
If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each object in the bucket. This value doesn't reflect the storage size of all versions of each object in the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SIZEINBYTES() |
Getter for SIZEINBYTES, with configurable default |
ASK_SIZEINBYTES() |
Getter for SIZEINBYTES w/ exceptions if field has no value |
HAS_SIZEINBYTES() |
Determine if SIZEINBYTES has a value |
sizeInBytesCompressed¶
The total storage size, in bytes, of the objects that are compressed (.gz, .gzip, .zip) files in the bucket.
If versioning is enabled for the bucket, Amazon Macie calculates this value based on the size of the latest version of each applicable object in the bucket. This value doesn't reflect the storage size of all versions of each applicable object in the bucket.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_SIZEINBYTESCOMPRESSED() |
Getter for SIZEINBYTESCOMPRESSED, with configurable default |
ASK_SIZEINBYTESCOMPRESSED() |
Getter for SIZEINBYTESCOMPRESSED w/ exceptions if field has |
HAS_SIZEINBYTESCOMPRESSED() |
Determine if SIZEINBYTESCOMPRESSED has a value |
unclassifiableObjectCount¶
The total number of objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_UNCLASSIFIABLEOBJCOUNT() |
Getter for UNCLASSIFIABLEOBJECTCOUNT |
unclassifiableObjectSizeInBytes¶
The total storage size, in bytes, of the objects that Amazon Macie can't analyze in the bucket. These objects don't use a supported storage class or don't have a file name extension for a supported file or storage format.
Accessible with the following methods¶
| Method | Description |
|---|---|
GET_UNCLIFIABLEOBJSIZEINBY00() |
Getter for UNCLASSIFIABLEOBJSIZEINBYTES |