本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateCertificate
更新证书的活动日期和非活动日期。
请求语法
{
"ActiveDate": number
,
"CertificateId": "string
",
"Description": "string
",
"InactiveDate": number
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
请求接受采用 JSON 格式的以下数据。
- ActiveDate
-
指定证书何时生效的可选日期。
类型:时间戳
必需:否
- CertificateId
-
您要更新的证书对象的标识符。
类型:字符串
长度限制:固定长度为 22。
模式:
cert-([0-9a-f]{17})
必需:是
- Description
-
帮助识别证书的简短描述。
类型:字符串
长度限制:最小长度为 1。最大长度为 200。
模式:
[\p{Graph}]+
必需:否
- InactiveDate
-
指定证书何时失效的可选日期。
类型:时间戳
必需:否
响应语法
{
"CertificateId": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
- CertificateId
-
返回您要更新的证书对象的标识符。
类型:字符串
长度限制:固定长度为 22。
模式:
cert-([0-9a-f]{17})
错误
有关所有操作返回的常见错误的信息,请参阅常见错误。
- InternalServiceError
-
当 Amazon Transfer Family服务中发生错误时,会引发此异常。
HTTP 状态代码:500
- InvalidRequestException
-
当客户端提交格式错误的请求时,会引发此异常。
HTTP 状态代码:400
- ResourceNotFoundException
-
当 AmazonTransfer Family 服务找不到资源时,就会引发此异常。
HTTP 状态代码:400
- ServiceUnavailableException
-
请求失败,因为 AmazonTransfer Family 服务不可用。
HTTP 状态代码:500
- ThrottlingException
-
由于请求限制而导致请求被拒绝。
HTTP 状态代码:400
示例
示例
以下示例更新了证书的有效日期,将有效日期设置为 2022 年 1 月 16 日 16:12:07 UTC — 5 小时。
示例请求
aws transfer update-certificate --certificate-id c-abcdefg123456hijk --active-date 2022-01-16T16:12:07-05:00
示例
以下是该 API 调用的示例响应。
示例响应
"CertificateId": "c-abcdefg123456hijk"
另请参阅
有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: