次の方法で共有


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 パラメーター

名前 / 必須 説明
accountName
path True

string

minLength: 3
maxLength: 24
pattern: ^[a-zA-Z0-9]+$

バッチアカウントの名前で、地域内で一意でなければならない。 バッチアカウント名は3文字から24文字の範囲で、数字と小文字のみを使用してください。 この名前は、アカウント作成地域のバッチサービスにアクセスするためのDNS名の一部として使われます。 たとえば、 http://accountname.region.batch.azure.com/と指定します。

certificateName
path True

string

minLength: 5
maxLength: 45
pattern: ^[\w]+-[\w]+$

証明書の識別子。 これは、ダッシュで区切られたアルゴリズムと拇印で構成され、要求の証明書データと一致する必要があります。 たとえば、SHA1-a3d1c5 です。

resourceGroupName
path True

string

minLength: 1
maxLength: 90

リソース グループの名前。 名前は大文字と小文字が区別されます。

subscriptionId
path True

string (uuid)

ターゲット サブスクリプションの ID。 値は UUID である必要があります。

api-version
query True

string

minLength: 1

この操作に使用する API バージョン。

応答

名前 説明
200 OK

Certificate

要求は成功しました。

ヘッダー

ETag: string

Other Status Codes

CloudError

予期しないエラー応答。

セキュリティ

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

要求のサンプル

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

応答のサンプル

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

要求のサンプル

GET https://management.azure.com/subscriptions/12345678-1234-1234-1234-123456789012/resourceGroups/default-azurebatch-japaneast/providers/Microsoft.Batch/batchAccounts/sampleacct/certificates/sha1-0a0e4f50d51beadeac1d35afc5116098e7902e6e?api-version=2024-07-01

応答のサンプル

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

証明書に関する情報が含まれています。

CertificateFormat

証明書の形式 (Pfx または Cer)。 省略した場合、既定値は Pfx です。

CertificateProvisioningState
CloudError

Batch サービスからのエラー応答。

CloudErrorBody

Batch サービスからのエラー応答。

createdByType

リソースを作成した ID の種類。

DeleteCertificateError

Batch サービスからのエラー応答。

systemData

リソースの作成と最後の変更に関連するメタデータ。

Certificate

証明書に関する情報が含まれています。

名前 説明
etag

string

コンカレンシー ステートメントに使用されるリソースの ETag。

id

string (arm-id)

リソースの完全修飾リソース ID。 例: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"

name

string

リソースの名前

properties.deleteCertificateError

DeleteCertificateError

証明書の削除中に発生したエラー
これは、証明書 provisioningState が 'Failed' の場合にのみ返されます。

properties.format

CertificateFormat

証明書の形式 (Pfx または Cer)。 省略した場合、既定値は Pfx です。

properties.previousProvisioningState

CertificateProvisioningState

リソースの以前のプロビジョニング済み状態

properties.previousProvisioningStateTransitionTime

string (date-time)

証明書が以前の状態になった時刻。

properties.provisioningState

CertificateProvisioningState

リソースのプロビジョニング済み状態

properties.provisioningStateTransitionTime

string (date-time)

証明書が現在の状態になった時刻。

properties.publicData

string

証明書の公開キー。

properties.thumbprint

string

証明書の拇印。
これは、名前の拇印と一致する必要があります。

properties.thumbprintAlgorithm

string

証明書の拇印のアルゴリズム。
これは、証明書名の最初の部分と一致する必要があります。 現在、'SHA1' である必要があります。

systemData

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

エラー応答の本文。

CloudErrorBody

Batch サービスからのエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。

details

CloudErrorBody[]

エラーに関する追加の詳細の一覧。

message

string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

target

string

特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。

createdByType

リソースを作成した ID の種類。

説明
User
Application
ManagedIdentity
Key

DeleteCertificateError

Batch サービスからのエラー応答。

名前 説明
code

string

エラーの識別子。 コードは不変であり、プログラムで使用することを目的としています。

details

DeleteCertificateError[]

エラーに関する追加の詳細の一覧。

message

string

ユーザー インターフェイスでの表示に適したエラーを説明するメッセージ。

target

string

特定のエラーのターゲット。 たとえば、エラーが発生したプロパティの名前です。

systemData

リソースの作成と最後の変更に関連するメタデータ。

名前 説明
createdAt

string (date-time)

リソース作成のタイムスタンプ (UTC)。

createdBy

string

リソースを作成した ID。

createdByType

createdByType

リソースを作成した ID の種類。

lastModifiedAt

string (date-time)

リソースの最終変更のタイムスタンプ (UTC)

lastModifiedBy

string

リソースを最後に変更した ID。

lastModifiedByType

createdByType

リソースを最後に変更した ID の種類。