AWS Service Catalog App Registry Update: Introduction of GetAssociate…

…dResource API and GetApplication response extension for Resource Groups support.
aws · Sep 1, 2021 · deef579 · deef579
1 parent 97a2604
commit deef579
Show file tree

Hide file tree

Showing 2 changed files with 151 additions and 15 deletions.
diff --git a/.changes/next-release/feature-AWSServiceCatalogAppRegistry-3a84c34.json b/.changes/next-release/feature-AWSServiceCatalogAppRegistry-3a84c34.json
@@ -0,0 +1,6 @@
+{
+    "type": "feature",
+    "category": "AWS Service Catalog App Registry",
+    "contributor": "",
+    "description": "Introduction of GetAssociatedResource API and GetApplication response extension for Resource Groups support."
+}
diff --git a/services/servicecatalogappregistry/src/main/resources/codegen-resources/service-2.json b/services/servicecatalogappregistry/src/main/resources/codegen-resources/service-2.json
@@ -152,6 +152,22 @@
       ],
       "documentation":"<p>Retrieves metadata information about one of your applications. The application can be specified either by its unique ID or by its name (which is unique within one account in one region at a given point in time). Specify by ID in automated workflows if you want to make sure that the exact same application is returned or a <code>ResourceNotFoundException</code> is thrown, avoiding the ABA addressing problem.</p>"
     },
+    "GetAssociatedResource":{
+      "name":"GetAssociatedResource",
+      "http":{
+        "method":"GET",
+        "requestUri":"/applications/{application}/resources/{resourceType}/{resource}"
+      },
+      "input":{"shape":"GetAssociatedResourceRequest"},
+      "output":{"shape":"GetAssociatedResourceResponse"},
+      "errors":[
+        {"shape":"ResourceNotFoundException"},
+        {"shape":"ValidationException"},
+        {"shape":"InternalServerException"}
+      ],
+      "documentation":"<p>Gets the resource associated with the application.</p>",
+      "idempotent":true
+    },
     "GetAttributeGroup":{
       "name":"GetAttributeGroup",
       "http":{
@@ -257,7 +273,7 @@
         {"shape":"InternalServerException"},
         {"shape":"ConflictException"}
       ],
-      "documentation":"<p>Syncs the resource with what is currently recorded in App registry. Specifically, the resource’s App registry system tags are synced with its associated application. The resource is removed if it is not associated with the application. The caller must have permissions to read and update the resource.</p>"
+      "documentation":"<p>Syncs the resource with current AppRegistry records.</p> <p>Specifically, the resource’s AppRegistry system tags sync with its associated application. We remove the resource's AppRegistry system tags if it does not associate with the application. The caller must have permissions to read and update the resource.</p>"
     },
     "TagResource":{
       "name":"TagResource",
@@ -354,21 +370,23 @@
           "documentation":"<p>Key-value pairs you can use to associate with the application.</p>"
         }
       },
-      "documentation":"<p>Represents a Service Catalog AppRegistry application that is the top-level node in a hierarchy of related cloud resource abstractions.</p>"
+      "documentation":"<p>Represents a Amazon Web Services Service Catalog AppRegistry application that is the top-level node in a hierarchy of related cloud resource abstractions.</p>"
     },
     "ApplicationArn":{
       "type":"string",
       "pattern":"arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/applications/[a-z0-9]+"
     },
     "ApplicationId":{
       "type":"string",
-      "pattern":"[a-z0-9]{12}"
+      "max":26,
+      "min":26,
+      "pattern":"[a-z0-9]+"
     },
     "ApplicationSpecifier":{
       "type":"string",
       "max":256,
       "min":1,
-      "pattern":"\\w+"
+      "pattern":"[-.\\w]+"
     },
     "ApplicationSummaries":{
       "type":"list",
@@ -402,7 +420,7 @@
           "documentation":"<p> The ISO-8601 formatted timestamp of the moment when the application was last updated.</p>"
         }
       },
-      "documentation":"<p>Summary of a Service Catalog AppRegistry application.</p>"
+      "documentation":"<p>Summary of a Amazon Web Services Service Catalog AppRegistry application.</p>"
     },
     "Arn":{
       "type":"string",
@@ -521,17 +539,17 @@
           "documentation":"<p>Key-value pairs you can use to associate with the attribute group.</p>"
         }
       },
-      "documentation":"<p>Represents a Service Catalog AppRegistry attribute group that is rich metadata which describes an application and its components.</p>"
+      "documentation":"<p>Represents a Amazon Web Services Service Catalog AppRegistry attribute group that is rich metadata which describes an application and its components.</p>"
     },
     "AttributeGroupArn":{
       "type":"string",
       "pattern":"arn:aws[-a-z]*:servicecatalog:[a-z]{2}(-gov)?-[a-z]+-\\d:\\d{12}:/attribute-groups/[a-z0-9]+"
     },
     "AttributeGroupId":{
       "type":"string",
-      "max":100,
-      "min":1,
-      "pattern":"[a-z0-9]{12}"
+      "max":26,
+      "min":26,
+      "pattern":"[a-z0-9]+"
     },
     "AttributeGroupIds":{
       "type":"list",
@@ -541,7 +559,7 @@
       "type":"string",
       "max":256,
       "min":1,
-      "pattern":"\\w+"
+      "pattern":"[-.\\w]+"
     },
     "AttributeGroupSummaries":{
       "type":"list",
@@ -575,7 +593,7 @@
           "documentation":"<p>The ISO-8601 formatted timestamp of the moment the attribute group was last updated. This time is the same as the creationTime for a newly created attribute group.</p>"
         }
       },
-      "documentation":"<p>Summary of a Service Catalog AppRegistry attribute group.</p>"
+      "documentation":"<p>Summary of a Amazon Web Services Service Catalog AppRegistry attribute group.</p>"
     },
     "Attributes":{
       "type":"string",
@@ -840,6 +858,47 @@
         "tags":{
           "shape":"Tags",
           "documentation":"<p>Key-value pairs associated with the application.</p>"
+        },
+        "integrations":{
+          "shape":"Integrations",
+          "documentation":"<p>The information about the integration of the application with other services, such as Resource Groups.</p>"
+        }
+      }
+    },
+    "GetAssociatedResourceRequest":{
+      "type":"structure",
+      "required":[
+        "application",
+        "resourceType",
+        "resource"
+      ],
+      "members":{
+        "application":{
+          "shape":"ApplicationSpecifier",
+          "documentation":"<p>The name or ID of the application.</p>",
+          "location":"uri",
+          "locationName":"application"
+        },
+        "resourceType":{
+          "shape":"ResourceType",
+          "documentation":"<p>The type of resource associated with the application.</p>",
+          "location":"uri",
+          "locationName":"resourceType"
+        },
+        "resource":{
+          "shape":"ResourceSpecifier",
+          "documentation":"<p>The name or ID of the resource associated with the application.</p>",
+          "location":"uri",
+          "locationName":"resource"
+        }
+      }
+    },
+    "GetAssociatedResourceResponse":{
+      "type":"structure",
+      "members":{
+        "resource":{
+          "shape":"Resource",
+          "documentation":"<p>The resource associated with the application.</p>"
         }
       }
     },
@@ -892,6 +951,16 @@
         }
       }
     },
+    "Integrations":{
+      "type":"structure",
+      "members":{
+        "resourceGroup":{
+          "shape":"ResourceGroup",
+          "documentation":"<p> The information about the resource group integration.</p>"
+        }
+      },
+      "documentation":"<p> The information about the service integration.</p>"
+    },
     "InternalServerException":{
       "type":"structure",
       "members":{
@@ -1070,14 +1139,65 @@
       "type":"string",
       "max":256,
       "min":1,
-      "pattern":"\\w+"
+      "pattern":"[-.\\w]+"
     },
     "NextToken":{
       "type":"string",
       "max":2024,
       "min":1,
       "pattern":"[A-Za-z0-9+/=]+"
     },
+    "Resource":{
+      "type":"structure",
+      "members":{
+        "name":{
+          "shape":"ResourceSpecifier",
+          "documentation":"<p>The name of the resource.</p>"
+        },
+        "arn":{
+          "shape":"StackArn",
+          "documentation":"<p>The Amazon resource name (ARN) of the resource.</p>"
+        },
+        "associationTime":{
+          "shape":"Timestamp",
+          "documentation":"<p>The time the resource was associated with the application.</p>"
+        },
+        "integrations":{
+          "shape":"ResourceIntegrations",
+          "documentation":"<p>The service integration information about the resource. </p>"
+        }
+      },
+      "documentation":"<p> The information about the resource.</p>"
+    },
+    "ResourceGroup":{
+      "type":"structure",
+      "members":{
+        "state":{
+          "shape":"ResourceGroupState",
+          "documentation":"<p>The state of the propagation process for the resource group. The states includes:</p> <p> <code>CREATING </code>if the resource group is in the process of being created.</p> <p> <code>CREATE_COMPLETE</code> if the resource group was created successfully.</p> <p> <code>CREATE_FAILED</code> if the resource group failed to be created.</p> <p> <code>UPDATING</code> if the resource group is in the process of being updated.</p> <p> <code>UPDATE_COMPLETE</code> if the resource group updated successfully.</p> <p> <code>UPDATE_FAILED</code> if the resource group could not update successfully.</p>"
+        },
+        "arn":{
+          "shape":"Arn",
+          "documentation":"<p>The Amazon resource name (ARN) of the resource group.</p>"
+        },
+        "errorMessage":{
+          "shape":"String",
+          "documentation":"<p>The error message that generates when the propagation process for the resource group fails.</p>"
+        }
+      },
+      "documentation":"<p>The information about the resource group integration.</p>"
+    },
+    "ResourceGroupState":{
+      "type":"string",
+      "enum":[
+        "CREATING",
+        "CREATE_COMPLETE",
+        "CREATE_FAILED",
+        "UPDATING",
+        "UPDATE_COMPLETE",
+        "UPDATE_FAILED"
+      ]
+    },
     "ResourceInfo":{
       "type":"structure",
       "members":{
@@ -1090,7 +1210,17 @@
           "documentation":"<p>The Amazon resource name (ARN) that specifies the resource across services.</p>"
         }
       },
-      "documentation":"<p>Information about the resource.</p>"
+      "documentation":"<p>The information about the resource.</p>"
+    },
+    "ResourceIntegrations":{
+      "type":"structure",
+      "members":{
+        "resourceGroup":{
+          "shape":"ResourceGroup",
+          "documentation":"<p>The information about the integration of Resource Groups.</p>"
+        }
+      },
+      "documentation":"<p>The service integration information about the resource.</p>"
     },
     "ResourceNotFoundException":{
       "type":"structure",
@@ -1151,7 +1281,7 @@
         },
         "resource":{
           "shape":"ResourceSpecifier",
-          "documentation":"<p>An entity you can work with and specify with a name or ID. Examples include an Amazon EC2 instance, an AWS CloudFormation stack, or an Amazon S3 bucket.</p>",
+          "documentation":"<p>An entity you can work with and specify with a name or ID. Examples include an Amazon EC2 instance, an Amazon Web Services CloudFormation stack, or an Amazon S3 bucket.</p>",
           "location":"uri",
           "locationName":"resource"
         }
@@ -1324,5 +1454,5 @@
       "exception":true
     }
   },
-  "documentation":"<p> AWS Service Catalog AppRegistry enables organizations to understand the application context of their AWS resources. AppRegistry provides a repository of your applications, their resources, and the application metadata that you use within your enterprise.</p>"
+  "documentation":"<p> Amazon Web Services Service Catalog AppRegistry enables organizations to understand the application context of their Amazon Web Services resources. AppRegistry provides a repository of your applications, their resources, and the application metadata that you use within your enterprise.</p>"
 }