{"note":"OpenAPI conversion -- returning structured metadata","name":"amazonaws-com-greengrass","description":"AWS Greengrass","version":"2017-06-07","base_url":"","endpoints":92,"raw":"@lap v0.3\n# Machine-readable API spec. Each @endpoint block is one API call.\n@api AWS Greengrass\n@version 2017-06-07\n@auth AWS SigV4\n@endpoints 92\n@hint download_for_search\n@toc greengrass(89), tags(3)\n\n@group greengrass\n@endpoint PUT /greengrass/groups/{GroupId}/role\n@desc Associates a role with a group. Your Greengrass core will use the role to access AWS cloud services. The role's permissions should allow Greengrass core Lambda functions to perform actions against the cloud.\n@required {GroupId: str, RoleArn: str}\n@returns(200) {AssociatedAt: str?}\n\n@endpoint PUT /greengrass/servicerole\n@desc Associates a role with your account. AWS IoT Greengrass will use the role to access your Lambda functions and AWS IoT resources. This is necessary for deployments to succeed. The role must have at least minimum permissions in the policy ''AWSGreengrassResourceAccessRolePolicy''.\n@required {RoleArn: str}\n@returns(200) {AssociatedAt: str?}\n\n@endpoint POST /greengrass/definition/connectors\n@desc Creates a connector definition. You may provide the initial version of the connector definition now or use ''CreateConnectorDefinitionVersion'' at a later time.\n@optional {X-Amzn-Client-Token: str, InitialVersion: ConnectorDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/connectors/{ConnectorDefinitionId}/versions\n@desc Creates a version of a connector definition which has already been defined.\n@required {ConnectorDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Connectors: [Connector]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/definition/cores\n@desc Creates a core definition. You may provide the initial version of the core definition now or use ''CreateCoreDefinitionVersion'' at a later time. Greengrass groups must each contain exactly one Greengrass core.\n@optional {X-Amzn-Client-Token: str, InitialVersion: CoreDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/cores/{CoreDefinitionId}/versions\n@desc Creates a version of a core definition that has already been defined. Greengrass groups must each contain exactly one Greengrass core.\n@required {CoreDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Cores: [Core]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/groups/{GroupId}/deployments\n@desc Creates a deployment. ''CreateDeployment'' requests are idempotent with respect to the ''X-Amzn-Client-Token'' token and the request parameters.\n@required {GroupId: str, DeploymentType: str}\n@optional {X-Amzn-Client-Token: str, DeploymentId: str, GroupVersionId: str}\n@returns(200) {DeploymentArn: str?, DeploymentId: str?}\n\n@endpoint POST /greengrass/definition/devices\n@desc Creates a device definition. You may provide the initial version of the device definition now or use ''CreateDeviceDefinitionVersion'' at a later time.\n@optional {X-Amzn-Client-Token: str, InitialVersion: DeviceDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/devices/{DeviceDefinitionId}/versions\n@desc Creates a version of a device definition that has already been defined.\n@required {DeviceDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Devices: [Device]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/definition/functions\n@desc Creates a Lambda function definition which contains a list of Lambda functions and their configurations to be used in a group. You can create an initial version of the definition by providing a list of Lambda functions and their configurations now, or use ''CreateFunctionDefinitionVersion'' later.\n@optional {X-Amzn-Client-Token: str, InitialVersion: FunctionDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/functions/{FunctionDefinitionId}/versions\n@desc Creates a version of a Lambda function definition that has already been defined.\n@required {FunctionDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, DefaultConfig: FunctionDefaultConfig, Functions: [Function]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/groups\n@desc Creates a group. You may provide the initial version of the group or use ''CreateGroupVersion'' at a later time. Tip: You can use the ''gg_group_setup'' package (https://github.com/awslabs/aws-greengrass-group-setup) as a library or command-line application to create and deploy Greengrass groups.\n@required {Name: str}\n@optional {X-Amzn-Client-Token: str, InitialVersion: GroupVersion, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/groups/{GroupId}/certificateauthorities\n@desc Creates a CA for the group. If a CA already exists, it will rotate the existing CA.\n@required {GroupId: str}\n@optional {X-Amzn-Client-Token: str}\n@returns(200) {GroupCertificateAuthorityArn: str?}\n\n@endpoint POST /greengrass/groups/{GroupId}/versions\n@desc Creates a version of a group which has already been defined.\n@required {GroupId: str}\n@optional {X-Amzn-Client-Token: str, ConnectorDefinitionVersionArn: str, CoreDefinitionVersionArn: str, DeviceDefinitionVersionArn: str, FunctionDefinitionVersionArn: str, LoggerDefinitionVersionArn: str, ResourceDefinitionVersionArn: str, SubscriptionDefinitionVersionArn: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/definition/loggers\n@desc Creates a logger definition. You may provide the initial version of the logger definition now or use ''CreateLoggerDefinitionVersion'' at a later time.\n@optional {X-Amzn-Client-Token: str, InitialVersion: LoggerDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/loggers/{LoggerDefinitionId}/versions\n@desc Creates a version of a logger definition that has already been defined.\n@required {LoggerDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Loggers: [Logger]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/definition/resources\n@desc Creates a resource definition which contains a list of resources to be used in a group. You can create an initial version of the definition by providing a list of resources now, or use ''CreateResourceDefinitionVersion'' later.\n@optional {X-Amzn-Client-Token: str, InitialVersion: ResourceDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/resources/{ResourceDefinitionId}/versions\n@desc Creates a version of a resource definition that has already been defined.\n@required {ResourceDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Resources: [Resource]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint POST /greengrass/updates\n@desc Creates a software update for a core or group of cores (specified as an IoT thing group.) Use this to update the OTA Agent as well as the Greengrass core software. It makes use of the IoT Jobs feature which provides additional commands to manage a Greengrass core software update job.\n@required {S3UrlSignerRole: str, SoftwareToUpdate: str, UpdateTargets: [str], UpdateTargetsArchitecture: str, UpdateTargetsOperatingSystem: str}\n@optional {X-Amzn-Client-Token: str, UpdateAgentLogLevel: str}\n@returns(200) {IotJobArn: str?, IotJobId: str?, PlatformSoftwareVersion: str?}\n\n@endpoint POST /greengrass/definition/subscriptions\n@desc Creates a subscription definition. You may provide the initial version of the subscription definition now or use ''CreateSubscriptionDefinitionVersion'' at a later time.\n@optional {X-Amzn-Client-Token: str, InitialVersion: SubscriptionDefinitionVersion, Name: str, tags: map<str,str>}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?}\n\n@endpoint POST /greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions\n@desc Creates a version of a subscription definition which has already been defined.\n@required {SubscriptionDefinitionId: str}\n@optional {X-Amzn-Client-Token: str, Subscriptions: [Subscription]}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, Version: str?}\n\n@endpoint DELETE /greengrass/definition/connectors/{ConnectorDefinitionId}\n@desc Deletes a connector definition.\n@required {ConnectorDefinitionId: str}\n\n@endpoint DELETE /greengrass/definition/cores/{CoreDefinitionId}\n@desc Deletes a core definition.\n@required {CoreDefinitionId: str}\n\n@endpoint DELETE /greengrass/definition/devices/{DeviceDefinitionId}\n@desc Deletes a device definition.\n@required {DeviceDefinitionId: str}\n\n@endpoint DELETE /greengrass/definition/functions/{FunctionDefinitionId}\n@desc Deletes a Lambda function definition.\n@required {FunctionDefinitionId: str}\n\n@endpoint DELETE /greengrass/groups/{GroupId}\n@desc Deletes a group.\n@required {GroupId: str}\n\n@endpoint DELETE /greengrass/definition/loggers/{LoggerDefinitionId}\n@desc Deletes a logger definition.\n@required {LoggerDefinitionId: str}\n\n@endpoint DELETE /greengrass/definition/resources/{ResourceDefinitionId}\n@desc Deletes a resource definition.\n@required {ResourceDefinitionId: str}\n\n@endpoint DELETE /greengrass/definition/subscriptions/{SubscriptionDefinitionId}\n@desc Deletes a subscription definition.\n@required {SubscriptionDefinitionId: str}\n\n@endpoint DELETE /greengrass/groups/{GroupId}/role\n@desc Disassociates the role from a group.\n@required {GroupId: str}\n@returns(200) {DisassociatedAt: str?}\n\n@endpoint DELETE /greengrass/servicerole\n@desc Disassociates the service role from your account. Without a service role, deployments will not work.\n@returns(200) {DisassociatedAt: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/role\n@desc Retrieves the role associated with a particular group.\n@required {GroupId: str}\n@returns(200) {AssociatedAt: str?, RoleArn: str?}\n\n@endpoint GET /greengrass/bulk/deployments/{BulkDeploymentId}/status\n@desc Returns the status of a bulk deployment.\n@required {BulkDeploymentId: str}\n@returns(200) {BulkDeploymentMetrics: BulkDeploymentMetrics?{InvalidInputRecords: int?, RecordsProcessed: int?, RetryAttempts: int?}, BulkDeploymentStatus: str?, CreatedAt: str?, ErrorDetails: [ErrorDetail]?, ErrorMessage: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/things/{ThingName}/connectivityInfo\n@desc Retrieves the connectivity information for a core.\n@required {ThingName: str}\n@returns(200) {ConnectivityInfo: [ConnectivityInfo]?, Message: str?}\n\n@endpoint GET /greengrass/definition/connectors/{ConnectorDefinitionId}\n@desc Retrieves information about a connector definition.\n@required {ConnectorDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/connectors/{ConnectorDefinitionId}/versions/{ConnectorDefinitionVersionId}\n@desc Retrieves information about a connector definition version, including the connectors that the version contains. Connectors are prebuilt modules that interact with local infrastructure, device protocols, AWS, and other cloud services.\n@required {ConnectorDefinitionId: str, ConnectorDefinitionVersionId: str}\n@optional {NextToken: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: ConnectorDefinitionVersion?{Connectors: [Connector]?}, Id: str?, NextToken: str?, Version: str?}\n\n@endpoint GET /greengrass/definition/cores/{CoreDefinitionId}\n@desc Retrieves information about a core definition version.\n@required {CoreDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/cores/{CoreDefinitionId}/versions/{CoreDefinitionVersionId}\n@desc Retrieves information about a core definition version.\n@required {CoreDefinitionId: str, CoreDefinitionVersionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: CoreDefinitionVersion?{Cores: [Core]?}, Id: str?, NextToken: str?, Version: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/deployments/{DeploymentId}/status\n@desc Returns the status of a deployment.\n@required {DeploymentId: str, GroupId: str}\n@returns(200) {DeploymentStatus: str?, DeploymentType: str?, ErrorDetails: [ErrorDetail]?, ErrorMessage: str?, UpdatedAt: str?}\n\n@endpoint GET /greengrass/definition/devices/{DeviceDefinitionId}\n@desc Retrieves information about a device definition.\n@required {DeviceDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/devices/{DeviceDefinitionId}/versions/{DeviceDefinitionVersionId}\n@desc Retrieves information about a device definition version.\n@required {DeviceDefinitionId: str, DeviceDefinitionVersionId: str}\n@optional {NextToken: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: DeviceDefinitionVersion?{Devices: [Device]?}, Id: str?, NextToken: str?, Version: str?}\n\n@endpoint GET /greengrass/definition/functions/{FunctionDefinitionId}\n@desc Retrieves information about a Lambda function definition, including its creation time and latest version.\n@required {FunctionDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/functions/{FunctionDefinitionId}/versions/{FunctionDefinitionVersionId}\n@desc Retrieves information about a Lambda function definition version, including which Lambda functions are included in the version and their configurations.\n@required {FunctionDefinitionId: str, FunctionDefinitionVersionId: str}\n@optional {NextToken: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: FunctionDefinitionVersion?{DefaultConfig: FunctionDefaultConfig?{Execution: FunctionDefaultExecutionConfig?{IsolationMode: str?, RunAs: FunctionRunAsConfig?}}, Functions: [Function]?}, Id: str?, NextToken: str?, Version: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}\n@desc Retrieves information about a group.\n@required {GroupId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/groups/{GroupId}/certificateauthorities/{CertificateAuthorityId}\n@desc Retreives the CA associated with a group. Returns the public key of the CA.\n@required {CertificateAuthorityId: str, GroupId: str}\n@returns(200) {GroupCertificateAuthorityArn: str?, GroupCertificateAuthorityId: str?, PemEncodedCertificate: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/certificateauthorities/configuration/expiry\n@desc Retrieves the current configuration for the CA used by the group.\n@required {GroupId: str}\n@returns(200) {CertificateAuthorityExpiryInMilliseconds: str?, CertificateExpiryInMilliseconds: str?, GroupId: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/versions/{GroupVersionId}\n@desc Retrieves information about a group version.\n@required {GroupId: str, GroupVersionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: GroupVersion?{ConnectorDefinitionVersionArn: str?, CoreDefinitionVersionArn: str?, DeviceDefinitionVersionArn: str?, FunctionDefinitionVersionArn: str?, LoggerDefinitionVersionArn: str?, ResourceDefinitionVersionArn: str?, SubscriptionDefinitionVersionArn: str?}, Id: str?, Version: str?}\n\n@endpoint GET /greengrass/definition/loggers/{LoggerDefinitionId}\n@desc Retrieves information about a logger definition.\n@required {LoggerDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/loggers/{LoggerDefinitionId}/versions/{LoggerDefinitionVersionId}\n@desc Retrieves information about a logger definition version.\n@required {LoggerDefinitionId: str, LoggerDefinitionVersionId: str}\n@optional {NextToken: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: LoggerDefinitionVersion?{Loggers: [Logger]?}, Id: str?, Version: str?}\n\n@endpoint GET /greengrass/definition/resources/{ResourceDefinitionId}\n@desc Retrieves information about a resource definition, including its creation time and latest version.\n@required {ResourceDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/resources/{ResourceDefinitionId}/versions/{ResourceDefinitionVersionId}\n@desc Retrieves information about a resource definition version, including which resources are included in the version.\n@required {ResourceDefinitionId: str, ResourceDefinitionVersionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: ResourceDefinitionVersion?{Resources: [Resource]?}, Id: str?, Version: str?}\n\n@endpoint GET /greengrass/servicerole\n@desc Retrieves the service role that is attached to your account.\n@returns(200) {AssociatedAt: str?, RoleArn: str?}\n\n@endpoint GET /greengrass/definition/subscriptions/{SubscriptionDefinitionId}\n@desc Retrieves information about a subscription definition.\n@required {SubscriptionDefinitionId: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Id: str?, LastUpdatedTimestamp: str?, LatestVersion: str?, LatestVersionArn: str?, Name: str?, tags: map<str,str>?}\n\n@endpoint GET /greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions/{SubscriptionDefinitionVersionId}\n@desc Retrieves information about a subscription definition version.\n@required {SubscriptionDefinitionId: str, SubscriptionDefinitionVersionId: str}\n@optional {NextToken: str}\n@returns(200) {Arn: str?, CreationTimestamp: str?, Definition: SubscriptionDefinitionVersion?{Subscriptions: [Subscription]?}, Id: str?, NextToken: str?, Version: str?}\n\n@endpoint GET /greengrass/things/{ThingName}/runtimeconfig\n@desc Get the runtime configuration of a thing.\n@required {ThingName: str}\n@returns(200) {RuntimeConfiguration: RuntimeConfiguration?{TelemetryConfiguration: TelemetryConfiguration?{ConfigurationSyncStatus: str?, Telemetry: str}}}\n\n@endpoint GET /greengrass/bulk/deployments/{BulkDeploymentId}/detailed-reports\n@desc Gets a paginated list of the deployments that have been started in a bulk deployment operation, and their current deployment status.\n@required {BulkDeploymentId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Deployments: [BulkDeploymentResult]?, NextToken: str?}\n\n@endpoint GET /greengrass/bulk/deployments\n@desc Returns a list of bulk deployments.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {BulkDeployments: [BulkDeployment]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/connectors/{ConnectorDefinitionId}/versions\n@desc Lists the versions of a connector definition, which are containers for connectors. Connectors run on the Greengrass core and contain built-in integration with local infrastructure, device protocols, AWS, and other cloud services.\n@required {ConnectorDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/connectors\n@desc Retrieves a list of connector definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/cores/{CoreDefinitionId}/versions\n@desc Lists the versions of a core definition.\n@required {CoreDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/cores\n@desc Retrieves a list of core definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/deployments\n@desc Returns a history of deployments for the group.\n@required {GroupId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Deployments: [Deployment]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/devices/{DeviceDefinitionId}/versions\n@desc Lists the versions of a device definition.\n@required {DeviceDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/devices\n@desc Retrieves a list of device definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/functions/{FunctionDefinitionId}/versions\n@desc Lists the versions of a Lambda function definition.\n@required {FunctionDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/functions\n@desc Retrieves a list of Lambda function definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/groups/{GroupId}/certificateauthorities\n@desc Retrieves the current CAs for a group.\n@required {GroupId: str}\n@returns(200) {GroupCertificateAuthorities: [GroupCertificateAuthorityProperties]?}\n\n@endpoint GET /greengrass/groups/{GroupId}/versions\n@desc Lists the versions of a group.\n@required {GroupId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/groups\n@desc Retrieves a list of groups.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Groups: [GroupInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/loggers/{LoggerDefinitionId}/versions\n@desc Lists the versions of a logger definition.\n@required {LoggerDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/loggers\n@desc Retrieves a list of logger definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/resources/{ResourceDefinitionId}/versions\n@desc Lists the versions of a resource definition.\n@required {ResourceDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/resources\n@desc Retrieves a list of resource definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endpoint GET /greengrass/definition/subscriptions/{SubscriptionDefinitionId}/versions\n@desc Lists the versions of a subscription definition.\n@required {SubscriptionDefinitionId: str}\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {NextToken: str?, Versions: [VersionInformation]?}\n\n@endpoint GET /greengrass/definition/subscriptions\n@desc Retrieves a list of subscription definitions.\n@optional {MaxResults: str, NextToken: str}\n@returns(200) {Definitions: [DefinitionInformation]?, NextToken: str?}\n\n@endgroup\n\n@group tags\n@endpoint GET /tags/{resource-arn}\n@desc Retrieves a list of resource tags for a resource arn.\n@required {ResourceArn: str}\n@returns(200) {tags: map<str,str>?}\n\n@endgroup\n\n@group greengrass\n@endpoint POST /greengrass/groups/{GroupId}/deployments/$reset\n@desc Resets a group's deployments.\n@required {GroupId: str}\n@optional {X-Amzn-Client-Token: str, Force: bool}\n@returns(200) {DeploymentArn: str?, DeploymentId: str?}\n\n@endpoint POST /greengrass/bulk/deployments\n@desc Deploys multiple groups in one operation. This action starts the bulk deployment of a specified set of group versions. Each group version deployment will be triggered with an adaptive rate that has a fixed upper limit. We recommend that you include an ''X-Amzn-Client-Token'' token in every ''StartBulkDeployment'' request. These requests are idempotent with respect to the token and the request parameters.\n@required {ExecutionRoleArn: str, InputFileUri: str}\n@optional {X-Amzn-Client-Token: str, tags: map<str,str>}\n@returns(200) {BulkDeploymentArn: str?, BulkDeploymentId: str?}\n\n@endpoint PUT /greengrass/bulk/deployments/{BulkDeploymentId}/$stop\n@desc Stops the execution of a bulk deployment. This action returns a status of ''Stopping'' until the deployment is stopped. You cannot start a new bulk deployment while a previous deployment is in the ''Stopping'' state. This action doesn't rollback completed deployments or cancel pending deployments.\n@required {BulkDeploymentId: str}\n\n@endgroup\n\n@group tags\n@endpoint POST /tags/{resource-arn}\n@desc Adds tags to a Greengrass resource. Valid resources are 'Group', 'ConnectorDefinition', 'CoreDefinition', 'DeviceDefinition', 'FunctionDefinition', 'LoggerDefinition', 'SubscriptionDefinition', 'ResourceDefinition', and 'BulkDeployment'.\n@required {ResourceArn: str}\n@optional {tags: map<str,str>}\n\n@endpoint DELETE /tags/{resource-arn}\n@desc Remove resource tags from a Greengrass Resource.\n@required {ResourceArn: str, tagKeys: [str]}\n\n@endgroup\n\n@group greengrass\n@endpoint PUT /greengrass/things/{ThingName}/connectivityInfo\n@desc Updates the connectivity information for the core. Any devices that belong to the group which has this core will receive this information in order to find the location of the core and connect to it.\n@required {ThingName: str}\n@optional {ConnectivityInfo: [ConnectivityInfo]}\n@returns(200) {Message: str?, Version: str?}\n\n@endpoint PUT /greengrass/definition/connectors/{ConnectorDefinitionId}\n@desc Updates a connector definition.\n@required {ConnectorDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/definition/cores/{CoreDefinitionId}\n@desc Updates a core definition.\n@required {CoreDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/definition/devices/{DeviceDefinitionId}\n@desc Updates a device definition.\n@required {DeviceDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/definition/functions/{FunctionDefinitionId}\n@desc Updates a Lambda function definition.\n@required {FunctionDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/groups/{GroupId}\n@desc Updates a group.\n@required {GroupId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/groups/{GroupId}/certificateauthorities/configuration/expiry\n@desc Updates the Certificate expiry time for a group.\n@required {GroupId: str}\n@optional {CertificateExpiryInMilliseconds: str}\n@returns(200) {CertificateAuthorityExpiryInMilliseconds: str?, CertificateExpiryInMilliseconds: str?, GroupId: str?}\n\n@endpoint PUT /greengrass/definition/loggers/{LoggerDefinitionId}\n@desc Updates a logger definition.\n@required {LoggerDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/definition/resources/{ResourceDefinitionId}\n@desc Updates a resource definition.\n@required {ResourceDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/definition/subscriptions/{SubscriptionDefinitionId}\n@desc Updates a subscription definition.\n@required {SubscriptionDefinitionId: str}\n@optional {Name: str}\n\n@endpoint PUT /greengrass/things/{ThingName}/runtimeconfig\n@desc Updates the runtime configuration of a thing.\n@required {ThingName: str}\n@optional {TelemetryConfiguration: TelemetryConfigurationUpdate}\n\n@endgroup\n\n@end\n"}