Certificate - Get
指定した証明書に関する情報を取得します。
警告: この操作は非推奨となり、2024 年 2 月以降に削除されます。 代わりに、Azure KeyVault 拡張機能 を使用してください。
GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/certificates/{certificateName}?api-version=2024-07-01
URI パラメーター
| 名前 | / | 必須 | 型 | 説明 |
|---|---|---|---|---|
|
account
|
path | True |
string minLength: 3maxLength: 24 pattern: ^[a-zA-Z0-9]+$ |
バッチアカウントの名前で、地域内で一意でなければならない。 バッチアカウント名は3文字から24文字の範囲で、数字と小文字のみを使用してください。 この名前は、アカウント作成地域のバッチサービスにアクセスするためのDNS名の一部として使われます。 たとえば、 |
|
certificate
|
path | True |
string minLength: 5maxLength: 45 pattern: ^[\w]+-[\w]+$ |
証明書の識別子。 これは、ダッシュで区切られたアルゴリズムと拇印で構成され、要求の証明書データと一致する必要があります。 たとえば、SHA1-a3d1c5 です。 |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
リソース グループの名前。 名前は大文字と小文字が区別されます。 |
|
subscription
|
path | True |
string (uuid) |
ターゲット サブスクリプションの ID。 値は UUID である必要があります。 |
|
api-version
|
query | True |
string minLength: 1 |
この操作に使用する API バージョン。 |
応答
| 名前 | 型 | 説明 |
|---|---|---|
| 200 OK |
要求は成功しました。 ヘッダー ETag: string |
|
| Other Status Codes |
予期しないエラー応答。 |
セキュリティ
azure_auth
Azure Active Directory OAuth2 フロー。
型:
oauth2
フロー:
implicit
Authorization URL (承認 URL):
https://login.microsoftonline.com/common/oauth2/authorize
スコープ
| 名前 | 説明 |
|---|---|
| user_impersonation | ユーザー アカウントを偽装する |
例
| Get Certificate |
| Get Certificate with Deletion Error |
Get Certificate
要求のサンプル
応答のサンプル
ETag: W/"0x8D4EDD5118668F7"
{
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"properties": {
"format": "Pfx",
"provisioningState": "Succeeded",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"publicData": "MIICrjCCAZagAwI...",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"thumbprintAlgorithm": "sha1"
}
}
Get Certificate with Deletion Error
要求のサンプル
応答のサンプル
ETag: W/"0x8D4EDD5118668F7"
{
"name": "sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"type": "Microsoft.Batch/batchAccounts/certificates",
"id": "/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/samplecct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"properties": {
"format": "Pfx",
"deleteCertificateError": {
"code": "NodesReferencingCertificate",
"message": "The specified certificate is being used by the below mentioned node(s)\nRequestId:2dc78afc-b15b-42d2-8c85-39cb61a0799e\nTime:2017-08-28T10:22:52.8633406Z",
"target": "BatchAccount",
"details": [
{
"code": "Nodes",
"message": "node1, node3"
}
]
},
"previousProvisioningState": "Deleting",
"previousProvisioningStateTransitionTime": "2017-07-21T00:15:25.5625498Z",
"provisioningState": "Failed",
"provisioningStateTransitionTime": "2017-07-21T01:47:38.4420202Z",
"publicData": "MIICrjCCAZagAwI...",
"thumbprint": "0a0e4f50d51beadeac1d35afc5116098e7902e6e",
"thumbprintAlgorithm": "sha1"
}
}
定義
| 名前 | 説明 |
|---|---|
| Certificate |
証明書に関する情報が含まれています。 |
|
Certificate |
証明書の形式 (Pfx または Cer)。 省略した場合、既定値は Pfx です。 |
|
Certificate |
|
|
Cloud |
Batch サービスからのエラー応答。 |
|
Cloud |
Batch サービスからのエラー応答。 |
|
created |
リソースを作成した ID の種類。 |
|
Delete |
Batch サービスからのエラー応答。 |
|
system |
リソースの作成と最後の変更に関連するメタデータ。 |
Certificate
証明書に関する情報が含まれています。
| 名前 | 型 | 説明 |
|---|---|---|
| etag |
string |
コンカレンシー ステートメントに使用されるリソースの ETag。 |
| id |
string (arm-id) |
リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}" |
| name |
string |
リソースの名前 |
| properties.deleteCertificateError |
証明書の削除中に発生したエラー |
|
| properties.format |
証明書の形式 (Pfx または Cer)。 省略した場合、既定値は Pfx です。 |
|
| properties.previousProvisioningState |
リソースの以前のプロビジョニング済み状態 |
|
| properties.previousProvisioningStateTransitionTime |
string (date-time) |
証明書が以前の状態になった時刻。 |
| properties.provisioningState |
リソースのプロビジョニング済み状態 |
|
| properties.provisioningStateTransitionTime |
string (date-time) |
証明書が現在の状態になった時刻。 |
| properties.publicData |
string |
証明書の公開キー。 |
| properties.thumbprint |
string |
証明書の拇印。 |
| properties.thumbprintAlgorithm |
string |
証明書の拇印のアルゴリズム。 |
| systemData |
createdBy および modifiedBy 情報を含む Azure Resource Manager メタデータ。 |
|
| tags |
object |
リソースのタグ。 |
| type |
string |
リソースの種類。 例: "Microsoft.Compute/virtualMachines" または "Microsoft.Storage/storageAccounts" |
CertificateFormat
証明書の形式 (Pfx または Cer)。 省略した場合、既定値は Pfx です。
| 値 | 説明 |
|---|---|
| Pfx |
証明書は PFX (PKCS#12) 形式の証明書または証明書チェーンです。 |
| Cer |
証明書は、base64 でエンコードされた X.509 証明書です。 |
CertificateProvisioningState
| 値 | 説明 |
|---|---|
| Succeeded |
証明書はプールで使用できます。 |
| Deleting |
ユーザーは証明書の削除を要求しましたが、削除操作はまだ完了していません。 プールの作成時または更新時に証明書を参照することはできません。 |
| Failed |
ユーザーは証明書の削除を要求しましたが、証明書への参照が残っているプールがあるか、1 つ以上のコンピューティング ノードにインストールされているプールがあります。 (後者は、証明書がプールから削除されているが、ノードがまだ再起動されていない場合に発生する可能性があります。ノードは、再起動時にのみ証明書を更新します)。証明書の削除の取り消し操作を使用して削除を取り消すか、削除を再試行する証明書の削除操作を使用できます。 |
CloudError
Batch サービスからのエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| error |
エラー応答の本文。 |
CloudErrorBody
Batch サービスからのエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
| details |
エラーに関する追加の詳細の一覧。 |
|
| message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
| target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
createdByType
リソースを作成した ID の種類。
| 値 | 説明 |
|---|---|
| User | |
| Application | |
| ManagedIdentity | |
| Key |
DeleteCertificateError
Batch サービスからのエラー応答。
| 名前 | 型 | 説明 |
|---|---|---|
| code |
string |
エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。 |
| details |
エラーに関する追加の詳細の一覧。 |
|
| message |
string |
ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。 |
| target |
string |
特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。 |
systemData
リソースの作成と最後の変更に関連するメタデータ。
| 名前 | 型 | 説明 |
|---|---|---|
| createdAt |
string (date-time) |
リソース作成のタイムスタンプ (UTC)。 |
| createdBy |
string |
リソースを作成した ID。 |
| createdByType |
リソースを作成した ID の種類。 |
|
| lastModifiedAt |
string (date-time) |
リソースの最終変更のタイムスタンプ (UTC) |
| lastModifiedBy |
string |
リソースを最後に変更した ID。 |
| lastModifiedByType |
リソースを最後に変更した ID の種類。 |