openapi: 3.0.0
info:
version: 2015-05-28
x-release: v4
title: AWS IoT Accept Certificate Transfer Provisioning Templates API
description: '
IoT provides secure, bi-directional communication between Internet-connected devices (such as sensors, actuators, embedded devices, or smart appliances) and the Amazon Web Services cloud. You can discover your custom IoT-Data endpoint to communicate with, configure rules for data processing and integration with other services, organize resources associated with each device (Registry), configure logging, and create and manage policies and credentials to authenticate devices.
The service endpoints that expose this API are listed in Amazon Web Services IoT Core Endpoints and Quotas. You must use the endpoint for the region that has the resources you want to access.
The service name used by Amazon Web Services Signature Version 4 to sign the request is: execute-api.
For more information about how IoT works, see the Developer Guide.
For information about how to use the credentials provider for IoT, see Authorizing Direct Calls to Amazon Web Services Services.
' x-logo: url: https://api.apis.guru/v2/cache/logo/https_twitter.com_awscloud_profile_image.png backgroundColor: '#FFFFFF' termsOfService: https://aws.amazon.com/service-terms/ contact: name: Mike Ralphson email: mike.ralphson@gmail.com url: https://github.com/mermade/aws2openapi x-twitter: PermittedSoc license: name: Apache 2.0 License url: http://www.apache.org/licenses/ x-providerName: amazonaws.com x-serviceName: iot x-aws-signingName: iot x-origin: - contentType: application/json url: https://raw.githubusercontent.com/aws/aws-sdk-js/master/apis/iot-2015-05-28.normal.json converter: url: https://github.com/mermade/aws2openapi version: 1.0.0 x-apisguru-driver: external x-apiClientRegistration: url: https://portal.aws.amazon.com/gp/aws/developer/registration/index.html?nc2=h_ct x-apisguru-categories: - cloud x-preferred: true servers: - url: http://iot.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWS IoT multi-region endpoint - url: https://iot.{region}.amazonaws.com variables: region: description: The AWS region enum: - us-east-1 - us-east-2 - us-west-1 - us-west-2 - us-gov-west-1 - us-gov-east-1 - ca-central-1 - eu-north-1 - eu-west-1 - eu-west-2 - eu-west-3 - eu-central-1 - eu-south-1 - af-south-1 - ap-northeast-1 - ap-northeast-2 - ap-northeast-3 - ap-southeast-1 - ap-southeast-2 - ap-east-1 - ap-south-1 - sa-east-1 - me-south-1 default: us-east-1 description: The AWS IoT multi-region endpoint - url: http://iot.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWS IoT endpoint for China (Beijing) and China (Ningxia) - url: https://iot.{region}.amazonaws.com.cn variables: region: description: The AWS region enum: - cn-north-1 - cn-northwest-1 default: cn-north-1 description: The AWS IoT endpoint for China (Beijing) and China (Ningxia) security: - hmac: [] tags: - name: Provisioning Templates paths: /provisioning-templates/{templateName}/provisioning-claim: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateProvisioningClaim description:Creates a provisioning claim.
Requires permission to access the CreateProvisioningClaim action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateProvisioningClaimResponse' '480': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '481': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '482': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '483': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' '484': description: ServiceUnavailableException content: application/json: schema: $ref: '#/components/schemas/ServiceUnavailableException' '485': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' parameters: - name: templateName in: path required: true description: The name of the provisioning template to use. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 summary: Amazon IoT Device Defender Create Provisioning Claim x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates /provisioning-templates: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateProvisioningTemplate description:Creates a provisioning template.
Requires permission to access the CreateProvisioningTemplate action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateProvisioningTemplateResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: LimitExceededException content: application/json: schema: $ref: '#/components/schemas/LimitExceededException' '483': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '484': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' '485': description: ResourceAlreadyExistsException content: application/json: schema: $ref: '#/components/schemas/ResourceAlreadyExistsException' parameters: [] requestBody: required: true content: application/json: schema: type: object required: - templateName - templateBody - provisioningRoleArn properties: templateName: description: The name of the provisioning template. type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 description: description: The description of the provisioning template. type: string pattern: '[^\p{C}]*' minLength: 0 maxLength: 500 templateBody: description: The JSON formatted contents of the provisioning template. type: string pattern: '[\s\S]*' minLength: 0 maxLength: 10240 enabled: description: True to enable the provisioning template, otherwise false. type: boolean provisioningRoleArn: description: The role ARN for the role associated with the provisioning template. This IoT role grants permission to provision a device. type: string minLength: 20 maxLength: 2048 preProvisioningHook: description: Structure that containspayloadVersion and targetArn.
type: object
properties:
payloadVersion:
allOf:
- $ref: '#/components/schemas/PayloadVersion'
- description: The payload that was sent to the target function.
Note: Only Lambda functions are currently supported.
targetArn: allOf: - $ref: '#/components/schemas/TargetArn' - description:The ARN of the target function.
Note: Only Lambda functions are currently supported.
tags: description: 'Metadata which can be used to manage the provisioning template.
For URI Request parameters use format: ...key1=value1&key2=value2...
For the CLI command-line parameter use format: &&tags "key1=value1&key2=value2..."
For the cli-input-json file use format: "tags": "key1=value1&key2=value2..."
FLEET_PROVISIONING. For more information about provisioning template, see: Provisioning template. '
type: string
enum:
- FLEET_PROVISIONING
- JITP
summary: Amazon IoT Device Defender Create Provisioning Template
x-microcks-operation:
delay: 0
dispatcher: FALLBACK
tags:
- Provisioning Templates
get:
operationId: ListProvisioningTemplates
description: Lists the provisioning templates in your Amazon Web Services account.
Requires permission to access the ListProvisioningTemplates action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListProvisioningTemplatesResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '483': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' parameters: - name: maxResults in: query required: false description: The maximum number of results to return at one time. schema: type: integer minimum: 1 maximum: 250 - name: nextToken in: query required: false description: A token to retrieve the next set of results. schema: type: string summary: Amazon IoT Device Defender List Provisioning Templates x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates /provisioning-templates/{templateName}/versions: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' post: operationId: CreateProvisioningTemplateVersion description:Creates a new version of a provisioning template.
Requires permission to access the CreateProvisioningTemplateVersion action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/CreateProvisioningTemplateVersionResponse' '480': description: VersionsLimitExceededException content: application/json: schema: $ref: '#/components/schemas/VersionsLimitExceededException' '481': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '482': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '483': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '484': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '485': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' '486': description: ConflictingResourceUpdateException content: application/json: schema: $ref: '#/components/schemas/ConflictingResourceUpdateException' parameters: - name: templateName in: path required: true description: The name of the provisioning template. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 - name: setAsDefault in: query required: false description: Sets a fleet provision template version as the default version. schema: type: boolean requestBody: required: true content: application/json: schema: type: object required: - templateBody properties: templateBody: description: The JSON formatted contents of the provisioning template. type: string pattern: '[\s\S]*' minLength: 0 maxLength: 10240 summary: Amazon IoT Device Defender Create Provisioning Template Version x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates get: operationId: ListProvisioningTemplateVersions description:A list of provisioning template versions.
Requires permission to access the ListProvisioningTemplateVersions action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/ListProvisioningTemplateVersionsResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '483': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '484': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' parameters: - name: templateName in: path required: true description: The name of the provisioning template. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 - name: maxResults in: query required: false description: The maximum number of results to return at one time. schema: type: integer minimum: 1 maximum: 250 - name: nextToken in: query required: false description: A token to retrieve the next set of results. schema: type: string summary: Amazon IoT Device Defender List Provisioning Template Versions x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates /provisioning-templates/{templateName}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' delete: operationId: DeleteProvisioningTemplate description:Deletes a provisioning template.
Requires permission to access the DeleteProvisioningTemplate action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteProvisioningTemplateResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '483': description: DeleteConflictException content: application/json: schema: $ref: '#/components/schemas/DeleteConflictException' '484': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '485': description: ConflictingResourceUpdateException content: application/json: schema: $ref: '#/components/schemas/ConflictingResourceUpdateException' '486': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' parameters: - name: templateName in: path required: true description: The name of the fleet provision template to delete. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 summary: Amazon IoT Device Defender Delete Provisioning Template x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates get: operationId: DescribeProvisioningTemplate description:Returns information about a provisioning template.
Requires permission to access the DescribeProvisioningTemplate action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DescribeProvisioningTemplateResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '483': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '484': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' parameters: - name: templateName in: path required: true description: The name of the provisioning template. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 summary: Amazon IoT Device Defender Describe Provisioning Template x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates patch: operationId: UpdateProvisioningTemplate description:Updates a provisioning template.
Requires permission to access the UpdateProvisioningTemplate action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/UpdateProvisioningTemplateResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '483': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' '484': description: ConflictingResourceUpdateException content: application/json: schema: $ref: '#/components/schemas/ConflictingResourceUpdateException' parameters: - name: templateName in: path required: true description: The name of the provisioning template. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 requestBody: required: true content: application/json: schema: type: object properties: description: description: The description of the provisioning template. type: string pattern: '[^\p{C}]*' minLength: 0 maxLength: 500 enabled: description: True to enable the provisioning template, otherwise false. type: boolean defaultVersionId: description: The ID of the default provisioning template version. type: integer provisioningRoleArn: description: The ARN of the role associated with the provisioning template. This IoT role grants permission to provision a device. type: string minLength: 20 maxLength: 2048 preProvisioningHook: description: Structure that containspayloadVersion and targetArn.
type: object
properties:
payloadVersion:
allOf:
- $ref: '#/components/schemas/PayloadVersion'
- description: The payload that was sent to the target function.
Note: Only Lambda functions are currently supported.
targetArn: allOf: - $ref: '#/components/schemas/TargetArn' - description:The ARN of the target function.
Note: Only Lambda functions are currently supported.
removePreProvisioningHook: description: Removes pre-provisioning hook template. type: boolean summary: Amazon IoT Device Defender Update Provisioning Template x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates /provisioning-templates/{templateName}/versions/{versionId}: parameters: - $ref: '#/components/parameters/X-Amz-Content-Sha256' - $ref: '#/components/parameters/X-Amz-Date' - $ref: '#/components/parameters/X-Amz-Algorithm' - $ref: '#/components/parameters/X-Amz-Credential' - $ref: '#/components/parameters/X-Amz-Security-Token' - $ref: '#/components/parameters/X-Amz-Signature' - $ref: '#/components/parameters/X-Amz-SignedHeaders' delete: operationId: DeleteProvisioningTemplateVersion description:Deletes a provisioning template version.
Requires permission to access the DeleteProvisioningTemplateVersion action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DeleteProvisioningTemplateVersionResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '483': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '484': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' '485': description: ConflictingResourceUpdateException content: application/json: schema: $ref: '#/components/schemas/ConflictingResourceUpdateException' '486': description: DeleteConflictException content: application/json: schema: $ref: '#/components/schemas/DeleteConflictException' parameters: - name: templateName in: path required: true description: The name of the provisioning template version to delete. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 - name: versionId in: path required: true description: The provisioning template version ID to delete. schema: type: integer summary: Amazon IoT Device Defender Delete Provisioning Template Version x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates get: operationId: DescribeProvisioningTemplateVersion description:Returns information about a provisioning template version.
Requires permission to access the DescribeProvisioningTemplateVersion action.
responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/DescribeProvisioningTemplateVersionResponse' '480': description: InternalFailureException content: application/json: schema: $ref: '#/components/schemas/InternalFailureException' '481': description: InvalidRequestException content: application/json: schema: $ref: '#/components/schemas/InvalidRequestException' '482': description: ThrottlingException content: application/json: schema: $ref: '#/components/schemas/ThrottlingException' '483': description: ResourceNotFoundException content: application/json: schema: $ref: '#/components/schemas/ResourceNotFoundException' '484': description: UnauthorizedException content: application/json: schema: $ref: '#/components/schemas/UnauthorizedException' parameters: - name: templateName in: path required: true description: The template name. schema: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 - name: versionId in: path required: true description: The provisioning template version ID. schema: type: integer summary: Amazon IoT Device Defender Describe Provisioning Template Version x-microcks-operation: delay: 0 dispatcher: FALLBACK tags: - Provisioning Templates components: schemas: CreateProvisioningTemplateVersionResponse: type: object properties: templateArn: allOf: - $ref: '#/components/schemas/TemplateArn' - description: The ARN that identifies the provisioning template. templateName: allOf: - $ref: '#/components/schemas/TemplateName' - description: The name of the provisioning template. versionId: allOf: - $ref: '#/components/schemas/TemplateVersionId' - description: The version of the provisioning template. isDefaultVersion: allOf: - $ref: '#/components/schemas/IsDefaultVersion' - description: True if the provisioning template version is the default version, otherwise false. ResourceNotFoundException: {} UpdateProvisioningTemplateResponse: type: object properties: {} DateType: type: string format: date-time InternalFailureException: {} DeleteConflictException: {} DescribeProvisioningTemplateVersionResponse: type: object properties: versionId: allOf: - $ref: '#/components/schemas/TemplateVersionId' - description: The provisioning template version ID. creationDate: allOf: - $ref: '#/components/schemas/DateType' - description: The date when the provisioning template version was created. templateBody: allOf: - $ref: '#/components/schemas/TemplateBody' - description: The JSON formatted contents of the provisioning template version. isDefaultVersion: allOf: - $ref: '#/components/schemas/IsDefaultVersion' - description: True if the provisioning template version is the default version. NextToken: type: string TemplateArn: type: string CreateProvisioningClaimResponse: type: object properties: certificateId: allOf: - $ref: '#/components/schemas/CertificateId' - description: The ID of the certificate. certificatePem: allOf: - $ref: '#/components/schemas/CertificatePem' - description: The provisioning claim certificate. keyPair: allOf: - $ref: '#/components/schemas/KeyPair' - description: The provisioning claim key pair. expiration: allOf: - $ref: '#/components/schemas/DateType' - description: The provisioning claim expiration time. CreateProvisioningTemplateResponse: type: object properties: templateArn: allOf: - $ref: '#/components/schemas/TemplateArn' - description: The ARN that identifies the provisioning template. templateName: allOf: - $ref: '#/components/schemas/TemplateName' - description: The name of the provisioning template. defaultVersionId: allOf: - $ref: '#/components/schemas/TemplateVersionId' - description: The default version of the provisioning template. DeleteProvisioningTemplateResponse: type: object properties: {} ServiceUnavailableException: {} TargetArn: type: string maxLength: 2048 ResourceAlreadyExistsException: {} UnauthorizedException: {} RoleArn: type: string minLength: 20 maxLength: 2048 CertificatePem: type: string pattern: '[\s\S]*' description: The PEM of a certificate. minLength: 1 maxLength: 65536 Tag: type: object required: - Key properties: Key: allOf: - $ref: '#/components/schemas/TagKey' - description: The tag's key. Value: allOf: - $ref: '#/components/schemas/TagValue' - description: The tag's value. description: A set of key/value pairs that are used to manage the resource. Enabled: type: boolean ListProvisioningTemplatesResponse: type: object properties: templates: allOf: - $ref: '#/components/schemas/ProvisioningTemplateListing' - description: A list of provisioning templates nextToken: allOf: - $ref: '#/components/schemas/NextToken' - description: A token to retrieve the next set of results. TagKey: type: string pattern: ^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$ minLength: 1 maxLength: 128 TemplateName: type: string pattern: ^[0-9A-Za-z_-]+$ minLength: 1 maxLength: 36 TagValue: type: string minLength: 0 maxLength: 256 KeyPair: type: object properties: PublicKey: allOf: - $ref: '#/components/schemas/PublicKey' - description: The public key. PrivateKey: allOf: - $ref: '#/components/schemas/PrivateKey' - description: The private key. description: Describes a key pair. PublicKey: type: string minLength: 1 IsDefaultVersion: type: boolean TemplateBody: type: string pattern: '[\s\S]*' minLength: 0 maxLength: 10240 DeleteProvisioningTemplateVersionResponse: type: object properties: {} ThrottlingException: {} InvalidRequestException: {} PrivateKey: type: string minLength: 1 format: password VersionsLimitExceededException: {} CertificateId: type: string pattern: (0x)?[a-fA-F0-9]+ minLength: 64 maxLength: 64 ProvisioningHook: type: object required: - targetArn properties: payloadVersion: allOf: - $ref: '#/components/schemas/PayloadVersion' - description:The payload that was sent to the target function.
Note: Only Lambda functions are currently supported.
targetArn: allOf: - $ref: '#/components/schemas/TargetArn' - description:The ARN of the target function.
Note: Only Lambda functions are currently supported.
description: Structure that containspayloadVersion and targetArn.
ProvisioningTemplateVersionSummary:
type: object
properties:
versionId:
allOf:
- $ref: '#/components/schemas/TemplateVersionId'
- description: The ID of the fleet provisioning template version.
creationDate:
allOf:
- $ref: '#/components/schemas/DateType'
- description: The date when the provisioning template version was created
isDefaultVersion:
allOf:
- $ref: '#/components/schemas/IsDefaultVersion'
- description: True if the provisioning template version is the default version, otherwise false.
description: A summary of information about a fleet provision template version.
ProvisioningTemplateListing:
type: array
items:
$ref: '#/components/schemas/ProvisioningTemplateSummary'
PayloadVersion:
type: string
pattern: ^[0-9-]+$
minLength: 10
maxLength: 32
ConflictingResourceUpdateException: {}
TemplateVersionId:
type: integer
DescribeProvisioningTemplateResponse:
type: object
properties:
templateArn:
allOf:
- $ref: '#/components/schemas/TemplateArn'
- description: The ARN of the provisioning template.
templateName:
allOf:
- $ref: '#/components/schemas/TemplateName'
- description: The name of the provisioning template.
description:
allOf:
- $ref: '#/components/schemas/TemplateDescription'
- description: The description of the provisioning template.
creationDate:
allOf:
- $ref: '#/components/schemas/DateType'
- description: The date when the provisioning template was created.
lastModifiedDate:
allOf:
- $ref: '#/components/schemas/DateType'
- description: The date when the provisioning template was last modified.
defaultVersionId:
allOf:
- $ref: '#/components/schemas/TemplateVersionId'
- description: The default fleet template version ID.
templateBody:
allOf:
- $ref: '#/components/schemas/TemplateBody'
- description: The JSON formatted contents of the provisioning template.
enabled:
allOf:
- $ref: '#/components/schemas/Enabled'
- description: True if the provisioning template is enabled, otherwise false.
provisioningRoleArn:
allOf:
- $ref: '#/components/schemas/RoleArn'
- description: The ARN of the role associated with the provisioning template. This IoT role grants permission to provision a device.
preProvisioningHook:
allOf:
- $ref: '#/components/schemas/ProvisioningHook'
- description: Gets information about a pre-provisioned hook.
type:
allOf:
- $ref: '#/components/schemas/TemplateType'
- description: 'The type you define in a provisioning template. You can create a template with only one type. You can''t change the template type after its creation. The default value is FLEET_PROVISIONING. For more information about provisioning template, see: Provisioning template. '
TemplateType:
type: string
enum:
- FLEET_PROVISIONING
- JITP
TemplateDescription:
type: string
pattern: '[^\p{C}]*'
minLength: 0
maxLength: 500
ProvisioningTemplateSummary:
type: object
properties:
templateArn:
allOf:
- $ref: '#/components/schemas/TemplateArn'
- description: The ARN of the provisioning template.
templateName:
allOf:
- $ref: '#/components/schemas/TemplateName'
- description: The name of the provisioning template.
description:
allOf:
- $ref: '#/components/schemas/TemplateDescription'
- description: The description of the provisioning template.
creationDate:
allOf:
- $ref: '#/components/schemas/DateType'
- description: The date when the provisioning template summary was created.
lastModifiedDate:
allOf:
- $ref: '#/components/schemas/DateType'
- description: The date when the provisioning template summary was last modified.
enabled:
allOf:
- $ref: '#/components/schemas/Enabled'
- description: True if the fleet provision template is enabled, otherwise false.
type:
allOf:
- $ref: '#/components/schemas/TemplateType'
- description: 'The type you define in a provisioning template. You can create a template with only one type. You can''t change the template type after its creation. The default value is FLEET_PROVISIONING. For more information about provisioning template, see: Provisioning template. '
description: A summary of information about a provisioning template.
LimitExceededException: {}
ProvisioningTemplateVersionListing:
type: array
items:
$ref: '#/components/schemas/ProvisioningTemplateVersionSummary'
ListProvisioningTemplateVersionsResponse:
type: object
properties:
versions:
allOf:
- $ref: '#/components/schemas/ProvisioningTemplateVersionListing'
- description: The list of provisioning template versions.
nextToken:
allOf:
- $ref: '#/components/schemas/NextToken'
- description: A token to retrieve the next set of results.
parameters:
X-Amz-Content-Sha256:
name: X-Amz-Content-Sha256
in: header
schema:
type: string
required: false
X-Amz-Date:
name: X-Amz-Date
in: header
schema:
type: string
required: false
X-Amz-Security-Token:
name: X-Amz-Security-Token
in: header
schema:
type: string
required: false
X-Amz-SignedHeaders:
name: X-Amz-SignedHeaders
in: header
schema:
type: string
required: false
X-Amz-Algorithm:
name: X-Amz-Algorithm
in: header
schema:
type: string
required: false
X-Amz-Signature:
name: X-Amz-Signature
in: header
schema:
type: string
required: false
X-Amz-Credential:
name: X-Amz-Credential
in: header
schema:
type: string
required: false
securitySchemes:
hmac:
type: apiKey
name: Authorization
in: header
description: Amazon Signature authorization v4
x-amazon-apigateway-authtype: awsSigv4
externalDocs:
description: Amazon Web Services documentation
url: https://docs.aws.amazon.com/iot/
x-hasEquivalentPaths: true