@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class AbstractAWSResourceGroupsTaggingAPI extends Object implements AWSResourceGroupsTaggingAPI
AWSResourceGroupsTaggingAPI. Convenient method forms pass through to the
corresponding overload that takes a request object, which throws an UnsupportedOperationException.ENDPOINT_PREFIX| Modifier | Constructor and Description |
|---|---|
protected |
AbstractAWSResourceGroupsTaggingAPI() |
| Modifier and Type | Method and Description |
|---|---|
DeleteTagPolicyResult |
deleteTagPolicy(DeleteTagPolicyRequest request)
Deletes the policy that is attached to the specified organization root or account.
|
DescribeReportCreationResult |
describeReportCreation(DescribeReportCreationRequest request)
Describes the status of the
StartReportCreation operation. |
DisableTagPoliciesResult |
disableTagPolicies(DisableTagPoliciesRequest request)
Disables tag policies for your organization and deletes all tag policies.
|
EnableTagPoliciesResult |
enableTagPolicies(EnableTagPoliciesRequest request)
Enables tag policies for your organization.
|
ResponseMetadata |
getCachedResponseMetadata(AmazonWebServiceRequest request)
Returns additional metadata for a previously executed successful request, typically used for debugging issues
where a service isn't acting as expected.
|
GetComplianceSummaryResult |
getComplianceSummary(GetComplianceSummaryRequest request)
Returns a table that shows counts of resources that are noncompliant with their tag policies.
|
GetEffectiveTagPolicyResult |
getEffectiveTagPolicy(GetEffectiveTagPolicyRequest request)
Returns the contents of the effective tag policy for the AWS account.
|
GetResourcesResult |
getResources(GetResourcesRequest request)
Returns all the tagged or previously tagged resources that are located in the specified Region for the AWS
account.
|
GetTagKeysResult |
getTagKeys(GetTagKeysRequest request)
Returns all tag keys in the specified Region for the AWS account.
|
GetTagPolicyResult |
getTagPolicy(GetTagPolicyRequest request)
Returns the policy that is attached to the specified target.
|
GetTagValuesResult |
getTagValues(GetTagValuesRequest request)
Returns all tag values for the specified key in the specified Region for the AWS account.
|
PutTagPolicyResult |
putTagPolicy(PutTagPolicyRequest request)
Validates the tag policy and then attaches it to the account or organization root.
|
void |
shutdown()
Shuts down this client object, releasing any resources that might be held open.
|
StartReportCreationResult |
startReportCreation(StartReportCreationRequest request)
Generates a report that lists all tagged resources in accounts across your organization, and whether each
resource is compliant with the effective tag policy.
|
TagResourcesResult |
tagResources(TagResourcesRequest request)
Applies one or more tags to the specified resources.
|
UntagResourcesResult |
untagResources(UntagResourcesRequest request)
Removes the specified tags from the specified resources.
|
protected AbstractAWSResourceGroupsTaggingAPI()
public DeleteTagPolicyResult deleteTagPolicy(DeleteTagPolicyRequest request)
AWSResourceGroupsTaggingAPIDeletes the policy that is attached to the specified organization root or account.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
deleteTagPolicy in interface AWSResourceGroupsTaggingAPIpublic DescribeReportCreationResult describeReportCreation(DescribeReportCreationRequest request)
AWSResourceGroupsTaggingAPI
Describes the status of the StartReportCreation operation.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
describeReportCreation in interface AWSResourceGroupsTaggingAPIpublic DisableTagPoliciesResult disableTagPolicies(DisableTagPoliciesRequest request)
AWSResourceGroupsTaggingAPIDisables tag policies for your organization and deletes all tag policies.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
Use caution when disabling tag policies, as this is a destructive operation that applies to your entire organization. You cannot undo this operation.
disableTagPolicies in interface AWSResourceGroupsTaggingAPIpublic EnableTagPoliciesResult enableTagPolicies(EnableTagPoliciesRequest request)
AWSResourceGroupsTaggingAPIEnables tag policies for your organization. To use tag policies, you must be using AWS Organizations with all features enabled.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
This operation does the following:
Enables tag policies for the specified organization.
Calls the
EnableAWSServiceAccess API on your behalf to allow service access with the
tagpolicies.tag.amazonaws.com service principal.
Creates a service-linked role
named AWSServiceRoleForTagPolicies.
For more information on tag policies, see Tag Policies in the AWS Resource Groups User Guide.
enableTagPolicies in interface AWSResourceGroupsTaggingAPIpublic GetComplianceSummaryResult getComplianceSummary(GetComplianceSummaryRequest request)
AWSResourceGroupsTaggingAPIReturns a table that shows counts of resources that are noncompliant with their tag policies.
For more information on tag policies, see Tag Policies in the AWS Resource Groups User Guide.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
getComplianceSummary in interface AWSResourceGroupsTaggingAPIpublic GetEffectiveTagPolicyResult getEffectiveTagPolicy(GetEffectiveTagPolicyRequest request)
AWSResourceGroupsTaggingAPIReturns the contents of the effective tag policy for the AWS account. Depending on how you use tag policies, the effective tag policy for an account is one of the following:
The tag policy attached to the organization that the account belongs to.
The tag policy attached to the account.
The combination of both policies if tag policies are attached to the organization root and account.
getEffectiveTagPolicy in interface AWSResourceGroupsTaggingAPIpublic GetResourcesResult getResources(GetResourcesRequest request)
AWSResourceGroupsTaggingAPIReturns all the tagged or previously tagged resources that are located in the specified Region for the AWS account.
Depending on what information you want returned, you can also specify the following:
Filters that specify what tags and resource types you want returned. The response includes all tags that are associated with the requested resources.
Information about compliance with tag policies. If supplied, the compliance check follows the specified tag policy instead of following the effective tag policy. For more information on tag policies, see Tag Policies in the AWS Resource Groups User Guide.
You can check the PaginationToken response parameter to determine if a query completed. Queries can
occasionally return fewer results on a page than allowed. The PaginationToken response parameter
value is null only when there are no more results to display.
getResources in interface AWSResourceGroupsTaggingAPIpublic GetTagKeysResult getTagKeys(GetTagKeysRequest request)
AWSResourceGroupsTaggingAPIReturns all tag keys in the specified Region for the AWS account.
You can check the PaginationToken response parameter to determine if a query completed. Queries can
occasionally return fewer results on a page than allowed. The PaginationToken response parameter
value is null only when there are no more results to display.
getTagKeys in interface AWSResourceGroupsTaggingAPIpublic GetTagPolicyResult getTagPolicy(GetTagPolicyRequest request)
AWSResourceGroupsTaggingAPIReturns the policy that is attached to the specified target.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
getTagPolicy in interface AWSResourceGroupsTaggingAPIpublic GetTagValuesResult getTagValues(GetTagValuesRequest request)
AWSResourceGroupsTaggingAPIReturns all tag values for the specified key in the specified Region for the AWS account.
You can check the PaginationToken response parameter to determine if a query completed. Queries can
occasionally return fewer results on a page than allowed. The PaginationToken response parameter
value is null only when there are no more results to display.
getTagValues in interface AWSResourceGroupsTaggingAPIpublic PutTagPolicyResult putTagPolicy(PutTagPolicyRequest request)
AWSResourceGroupsTaggingAPIValidates the tag policy and then attaches it to the account or organization root. This policy determines whether a resource is compliant.
Validating the tag policy includes checking that the tag policy document includes the required components, uses JSON syntax, and has fewer than 5,000 characters (including spaces). For more information, see Tag Policy Structure in the AWS Resource Groups User Guide.
If you later call this operation to attach a tag policy to the same organization root or account, it overwrites the original call without prompting you to confirm.
You can call this operation from the organization's master account only, and from the us-east-1 Region only.
putTagPolicy in interface AWSResourceGroupsTaggingAPIpublic StartReportCreationResult startReportCreation(StartReportCreationRequest request)
AWSResourceGroupsTaggingAPIGenerates a report that lists all tagged resources in accounts across your organization, and whether each resource is compliant with the effective tag policy.
You can call this operation from the organization's master account only and from the us-east-1 Region only.
startReportCreation in interface AWSResourceGroupsTaggingAPIpublic TagResourcesResult tagResources(TagResourcesRequest request)
AWSResourceGroupsTaggingAPIApplies one or more tags to the specified resources. Note the following:
Not all resources can have tags. For a list of resources that support tagging, see this list.
Each resource can have up to 50 tags.
You can only tag resources that are located in the specified Region for the AWS account.
To add tags to a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for adding tags. For more information, see Set Up Permissions in the AWS Resource Groups User Guide.
tagResources in interface AWSResourceGroupsTaggingAPIpublic UntagResourcesResult untagResources(UntagResourcesRequest request)
AWSResourceGroupsTaggingAPIRemoves the specified tags from the specified resources. When you specify a tag key, the action removes both that key and its associated value. The operation succeeds even if you attempt to remove tags from a resource that were already removed. Note the following:
To remove tags from a resource, you need the necessary permissions for the service that the resource belongs to as well as permissions for removing tags. For more information, see Set Up Permissions in the AWS Resource Groups User Guide.
You can only tag resources that are located in the specified Region for the AWS account.
untagResources in interface AWSResourceGroupsTaggingAPIpublic void shutdown()
AWSResourceGroupsTaggingAPIshutdown in interface AWSResourceGroupsTaggingAPIpublic ResponseMetadata getCachedResponseMetadata(AmazonWebServiceRequest request)
AWSResourceGroupsTaggingAPIResponse metadata is only cached for a limited period of time, so if you need to access this extra diagnostic information for an executed request, you should use this method to retrieve it as soon as possible after executing a request.
getCachedResponseMetadata in interface AWSResourceGroupsTaggingAPIrequest - The originally executed request.Copyright © 2019. All rights reserved.