你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Certificate - Create
在指定的帐户内创建新证书。
警告:此操作已弃用,将在 2024 年 2 月之后删除。 请改用 Azure KeyVault 扩展 。
PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates/{certificateName}?api-version=2024-02-01
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
account
|
path | True |
string |
Batch 帐户的名称。 Regex pattern: |
certificate
|
path | True |
string |
证书的标识符。 这必须由用短划线分隔的算法和指纹组成,并且必须与请求中的证书数据匹配。 例如 SHA1-a3d1c5。 Regex pattern: |
resource
|
path | True |
string |
包含 Batch 帐户的资源组的名称。 |
subscription
|
path | True |
string |
Azure 订阅 ID。 这是 GUID 格式的字符串, (例如 00000000-0000-0000-0000-00000000000000) |
api-version
|
query | True |
string |
要与 HTTP 请求一起使用的 API 版本。 |
请求头
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
If-Match |
string |
实体状态 (ETag) 要更新的证书版本。 仅当证书已存在时,值“*”才可用于应用操作。 如果省略,将始终应用此操作。 |
|
If-None-Match |
string |
设置为“*”以允许创建新证书,但阻止更新现有证书。 其他值将被忽略。 |
请求正文
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
properties.data | True |
string |
证书的 base64 编码内容。 |
properties.format |
Certificate |
证书的格式 - Pfx 或 Cer。 如果省略,则默认值为 Pfx。 |
|
properties.password |
string |
用于访问证书私钥的密码。 |
|
properties.thumbprint |
string |
证书的指纹。 |
|
properties.thumbprintAlgorithm |
string |
证书指纹的算法。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
操作成功。 响应包含证书实体。 Headers ETag: string |
|
Other Status Codes |
Cloud |
描述操作失败原因的错误响应。 |
安全性
azure_auth
Microsoft Entra OAuth 2.0 身份验证代码流
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
名称 | 说明 |
---|---|
user_impersonation | 模拟用户帐户 |
示例
Create |
Create |
Create |
CreateCertificate - Full
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-02-01
{
"properties": {
"thumbprintAlgorithm": "sha1",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"data": "MIIJsgIBAzCCCW4GCSqGSIb3DQE...",
"password": "<ExamplePassword>",
"format": "Pfx"
}
}
Sample Response
ETag: W/"0x8D4EDD5118668F7"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"etag": "W/\"0x8D4EDD5118668F7\"",
"properties": {
"thumbprintAlgorithm": "sha1",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"format": "Pfx",
"publicData": "MIICrjCCAZagAwI..."
}
}
CreateCertificate - Minimal Cer
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-02-01
{
"properties": {
"data": "MIICrjCCAZagAwI...",
"format": "Cer"
}
}
Sample Response
ETag: W/"0x8D4EDD5118668F7"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"etag": "W/\"0x8D4EDD5118668F7\"",
"properties": {
"thumbprintAlgorithm": "sha1",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"format": "Cer",
"publicData": "MIICrjCCAZagAwI..."
}
}
CreateCertificate - Minimal Pfx
Sample Request
PUT https://management.azure.com/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-02-01
{
"properties": {
"data": "MIIJsgIBAzCCCW4GCSqGSIb3DQE...",
"password": "<ExamplePassword>"
}
}
Sample Response
ETag: W/"0x8D4EDD5118668F7"
{
"id": "/subscriptions/subid/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"etag": "W/\"0x8D4EDD5118668F7\"",
"properties": {
"thumbprintAlgorithm": "sha1",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"format": "Pfx",
"publicData": "MIICrjCCAZagAwI..."
}
}
定义
名称 | 说明 |
---|---|
Certificate |
包含有关证书的信息。 |
Certificate |
包含有关证书的信息。 |
Certificate |
证书的格式 - Pfx 或 Cer。 如果省略,则默认值为 Pfx。 |
Certificate |
资源的预配状态 |
Cloud |
来自 Batch 服务的错误响应。 |
Cloud |
来自 Batch 服务的错误响应。 |
Delete |
来自 Batch 服务的错误响应。 |
Certificate
包含有关证书的信息。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
资源的 ETag,用于并发语句。 |
id |
string |
资源的 ID。 |
name |
string |
资源的名称。 |
properties.deleteCertificateError |
Delete |
删除证书时发生的错误 |
properties.format |
Certificate |
证书的格式 - Pfx 或 Cer。 如果省略,则默认值为 Pfx。 |
properties.previousProvisioningState |
Certificate |
资源的先前预配状态 |
properties.previousProvisioningStateTransitionTime |
string |
证书进入其先前状态的时间。 |
properties.provisioningState |
Certificate |
资源的预配状态 |
properties.provisioningStateTransitionTime |
string |
证书进入其当前状态的时间。 |
properties.publicData |
string |
证书的公钥。 |
properties.thumbprint |
string |
证书的指纹。 |
properties.thumbprintAlgorithm |
string |
证书指纹的算法。 |
type |
string |
资源类型。 |
CertificateCreateOrUpdateParameters
包含有关证书的信息。
名称 | 类型 | 说明 |
---|---|---|
etag |
string |
资源的 ETag,用于并发语句。 |
id |
string |
资源的 ID。 |
name |
string |
资源的名称。 |
properties.data |
string |
证书的 base64 编码内容。 |
properties.format |
Certificate |
证书的格式 - Pfx 或 Cer。 如果省略,则默认值为 Pfx。 |
properties.password |
string |
用于访问证书私钥的密码。 |
properties.thumbprint |
string |
证书的指纹。 |
properties.thumbprintAlgorithm |
string |
证书指纹的算法。 |
type |
string |
资源类型。 |
CertificateFormat
证书的格式 - Pfx 或 Cer。 如果省略,则默认值为 Pfx。
名称 | 类型 | 说明 |
---|---|---|
Cer |
string |
该证书是 base64 编码的 X.509 证书。 |
Pfx |
string |
该证书是 PFX (PKCS#12) 格式的证书或证书链。 |
CertificateProvisioningState
资源的预配状态
名称 | 类型 | 说明 |
---|---|---|
Deleting |
string |
用户已请求删除证书,但删除操作尚未完成。 创建或更新池时,不得引用证书。 |
Failed |
string |
用户请求删除证书,但仍有一些池引用证书,或者它仍安装在一个或多个计算节点上。 (如果证书已从池中删除,但节点尚未重启,则可能会出现后者。节点仅在重启时刷新其证书。) 可以使用取消证书删除操作来取消删除,也可以使用删除证书操作重试删除操作。 |
Succeeded |
string |
证书可用于池中。 |
CloudError
来自 Batch 服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
error |
Cloud |
错误响应的正文。 |
CloudErrorBody
来自 Batch 服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
Cloud |
有关错误的其他详细信息的列表。 |
message |
string |
描述错误的消息,该消息适用于在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,属性的名称出错。 |
DeleteCertificateError
来自 Batch 服务的错误响应。
名称 | 类型 | 说明 |
---|---|---|
code |
string |
错误的标识符。 代码是固定的,旨在以编程方式使用。 |
details |
Delete |
有关错误的其他详细信息的列表。 |
message |
string |
描述错误的消息,该消息适用于在用户界面中显示。 |
target |
string |
特定错误的目标。 例如,属性的名称出错。 |