すべてのプロダクト
Search

このプロダクト

    Certificate Management Service:GetInstanceDetail

    ドキュメントセンター

    Certificate Management Service:GetInstanceDetail

    最終更新日:Sep 07, 2026

    インスタンスの詳細を照会します。

    操作説明

    この操作は、インスタンス ID を使用して、証明書管理サービスコンソールで購入した非公開ルート認証局 (PCA) インスタンスのステータス情報を照会します。ステータス情報には、CA インスタンスステータス、含まれるデジタル証明書の数、発行されたデジタル証明書の数が含まれます。

    この操作の呼び出し前に、証明書管理サービスコンソール のルート CA リストで非公開ルート CA を購入している必要があります。詳細については、「非公開 CA の購入」を参照してください。

    QPS 制限

    単一ユーザーの QPS 制限は、1 秒あたり 10 回です。制限を超えると速度制限がトリガーされ、ビジネスに影響を与える可能性があります。この操作は適切に呼び出してください。

    今すぐお試しください

    この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

    テスト

    RAM 認証

    下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

    • アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。

    • API：アクションを具体的に実行するための API。

    • アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。

    • リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。

      • リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。

      • リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。

    • 条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。

    • 依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

    アクション

    アクセスレベル

    リソースタイプ

    条件キー

    依存アクション

    yundun-cert:GetInstanceDetail

    get

    *すべてのリソース。

    *

    		 なし なし

    リクエストパラメーター

    パラメーター

    型

    必須 / 任意

    説明

    例
    InstanceId

    string

    必須

    インスタンスの ID。

    cas_dv-cn-123

    InstanceId は、BSS を介して証明書プランを購入した後に ListInstances から取得します。まず、証明書管理サービスコンソールまたは BSS API を介して購入を完了してください。cas-upload-* フォーマットのインスタンス ID の場合、UploadUserCertificate 操作を呼び出して証明書をアップロードし、インスタンス ID を取得します。

    レスポンスフィールド

    フィールド

    型

    説明

    例

    object

    AutoReissue

    string

    自動再発行が有効かどうかを示します。有効な値:

    • enable: 有効。

    • disable: 無効。

    有効
    AutoReissueFlag

    integer

    現在のバージョンに自動再発行が含まれているかどうかを示します。有効な値:

    • 1: 含まれる。

    • 0: 含まれない。

    1
    AverageWaitingTime

    string

    この仕様の証明書を発行するための平均待機時間。単位: 秒。

    120
    Brand

    string

    CA ブランド。有効な値: WoSign、CFCA、DigiCert、GeoTrust、GlobalSign、vTrus、Alibaba。

    DigiCert
    CertIdentifier

    string

    グローバル証明書 ID。証明書 ID + "-" + サイトリージョン ID のフォーマットです。この ID は、Alibaba Cloud サービス間で共通して使用されます。

    • 中国サイト: 証明書 ID + "-cn-hangzhou"

    • 国際サイト: 証明書 ID + "-ap-southeast-1"

    例えば、証明書 ID が 123 の場合、中国サイトの CertIdentifier は "123-cn-hangzhou"、国際サイトの CertIdentifier は "123-ap-southeast-1" となります。

    22783111-cn-hangzhou
    CertificateId

    integer

    証明書 ID。

    1234567890
    CertificateName

    string

    インスタンスの名前。証明書が発行されるとき、この名前が証明書のデフォルト名として使用されます。

    123
    CertificateNotAfter

    integer

    最新の証明書の終了時刻 (UNIX タイムスタンプフォーマット)。証明書が発行されていない場合、この値は空です。値は秒単位で正確です。

    1801324800000
    CertificateNotBefore

    integer

    最新の証明書の開始時刻 (UNIX タイムスタンプフォーマット)。証明書が発行されていない場合、この値は空です。値は秒単位で正確です。

    1781568000000
    CertificateRevokeTime

    integer

    最新の証明書の失効時刻 (UNIX タイムスタンプフォーマット)。値は秒単位で正確です。

    1801324800000
    CertificateStatus

    string

    証明書のステータス。有効な値:

    • issued: 発行済み。

    • revoked: 失効済み。

    • willExpire: まもなく有効期限切れ。

    • expired: 有効期限切れ。

    issued
    CertificateType

    string

    証明書のタイプ。有効な値: DV、OV、EV。

    DV
    City

    string

    証明書購入者の会社または組織が所在する都市。証明書署名リクエストを生成する際にこのフィールドは必須です。デフォルト値: Beijing。

    Beijing
    CompanyId

    integer

    会社情報 ID。

    47305
    ContactIdList

    array

    連絡先 ID のリスト。

    integer

    連絡先 ID。

    123
    CountryCode

    string

    証明書組織の国またはリージョンコード。例えば、CN は中国、US は米国を示します。証明書署名リクエストを生成する際にこのフィールドは必須です。デフォルト値: CN。

    CN
    Csr

    string

    PEM フォーマットの証明書署名リクエスト。

    -----BEGIN CERTIFICATE REQUEST----- ...... -----END CERTIFICATE REQUEST-----
    DeploymentResourceCount

    integer

    証明書がデプロイされたクラウドリソースの数。

    30
    DeploymentUseCount

    integer

    クラウドサーバー Deployment の使用済みクォータ。

    30
    DingGroupList

    array<object>

    関連付けられたエキスパートサービス DingTalk グループのリスト。

    object

    関連付けられたエキスパートサービス DingTalk グループ。

    DingGroupInstanceId

    string

    エキスパートサービス DingTalk グループのインスタンス ID。

    123
    DingGroupName

    string

    エキスパートサービス DingTalk グループの名前。

    123
    DingGroupType

    string

    エキスパートサービス DingTalk グループのタイプ。有効な値:

    • expedite: アプリケーション支援

    • remote: リモート Deployment

    リモート
    DingGroupUrl

    string

    エキスパートサービス DingTalk グループに参加するための URL。

    https://123.com
    Domain

    string

    証明書にバインドされているドメイン名。

    example.com
    DomainValidationList

    array<object>

    検証対象のドメイン名のリスト。

    object

    検証対象のドメイン名。

    Cname

    string

    検証不要の権限付与のための CNAME ドメイン名レコード値。この値は空の場合があります。

    123.com
    CnameKey

    string

    CNAME ドメイン名検証のプレフィックス。

    abc
    Domain

    string

    検証対象のドメイン名。

    example.com
    RootDomain

    string

    ルートドメイン名。

    example.com
    ValidationKey

    string

    ホストレコード。

    @
    ValidationType

    string

    検証タイプ。有効な値: TXT、HTTP、CNAME ドメイン名。

    TXT
    ValidationValue

    string

    検証用のホストレコード値。

    123
    FullDomainCount

    integer

    完全に一致するドメイン名の数。

    1
    GenerateCsrMethod

    string

    証明書署名リクエストの生成に使用されるメソッド。有効な値:

    • online: オンラインシステム生成。Csr フィールドは無視されます。

    • upload: ユーザーアップロード。Csr フィールドは必須です。

    オンライン
    InstanceEndTime

    integer

    インスタンスの終了時刻 (UNIX タイムスタンプフォーマット)。証明書が発行されていない場合、この値は空です。値は秒単位で正確です。

    1801324800000
    InstanceId

    string

    インスタンスの ID。

    cas_dv-cn-123
    InstanceStartTime

    integer

    インスタンスの開始時刻 (UNIX タイムスタンプフォーマット)。証明書が発行されていない場合、この値は空です。値は秒単位で正確です。

    1801324800000
    InstanceType

    string

    インスタンスタイプ。有効な値:

    • BUY: 公式証明書

    • TEST: テスト証明書

    TEST
    KeyAlgorithm

    string

    証明書アルゴリズム。有効な値:

    • RSA_2048

    • RSA_3072

    • RSA_4096

    • ECC_256

    • SM2

    RSA_2048
    MonitorExpandFlag

    integer

    ドメイン名モニタリングのクォータを拡張できるかどうかを示します。有効な値:

    • 1: はい。

    • 0: いいえ。

    1
    MonitorUseCount

    integer

    ドメイン名モニタリングの使用済みクォータ。

    10
    OrderEndTime

    integer

    購入時のインスタンスの終了時刻 (UNIX タイムスタンプフォーマット)。この値は、インスタンスの購入持続時間を決定するために使用されます。

    1801324800000
    OrderStartTime

    integer

    購入時のインスタンスの開始時刻 (UNIX タイムスタンプフォーマット)。この値は、返金の期限を決定するために使用されます。値は秒単位で正確です。

    1801324800000
    PendingResult

    string

    最後の証明書操作中に CA によって返された結果。

    pending
    Province

    string

    会社が所在する都道府県またはリージョン。証明書署名リクエストを生成する際にこのフィールドは必須です。デフォルト値: Beijing。

    Beijing
    RequestId

    string

    リクエスト ID。Alibaba Cloud は、各 API リクエストに対して一意の識別子を生成します。この ID を使用して問題のトラブルシューティングを行えます。

    B2CE1D02-6D5E-56E5-A9BD-EE288255C7F9
    ResourceGroupId

    string

    リソースグループ ID。

    rg-aek****wia
    Spec

    string

    購入したインスタンスのスペック。

    ss.dv.t
    Status

    string

    インスタンスステータス。有効な値:

    • inactive: 使用待ち。

    • pending: 審査中。最新の証明書が審査されています。

    • willExpire: インスタンスがまもなく有効期限切れになります。

    • expired: インスタンスの有効期限が切れています。

    • refund: 返金済み。

    • normal: 法線。

    • closed: クローズ。インスタンスは使用できません。

    inactive
    Tags

    array<object>

    タグのリスト。

    object

    タグのリスト。

    TagKey

    string

    タグキー。

    test
    TagValue

    string

    タグ値。

    test
    TotalDeploymentCount

    integer

    クラウドサーバー Deployment の合計クォータ。

    60
    TotalMonitorCount

    integer

    ドメイン名モニタリングの合計クォータ。

    80
    UpgradeStatus

    string

    インスタンスのスペックアップステータス。有効な値:

    • none: インスタンスはスペックアップされていません。

    • payed: インスタンスのスペックアップの支払いが完了しています。

    • issued: インスタンスのスペックアップに対して最新の証明書が発行されています。

    none
    ValidationMethod

    string

    証明書アプリケーションの検証メソッド。有効な値:

    • DNS: TXT または CNAME ドメイン名レコードを使用した DNS 検証。

    • HTTP: ファイルベースの検証。

    DNS
    VersionType

    string

    バージョンタイプ。有効な値: FOTA: システムスペックアップ。APP: アプリケーションスペックアップ。

    0
    WildcardDomainCount

    integer

    ワイルドカードドメイン名の数。

    0

    例

    成功レスポンス

    JSONJSON

    {
  "AutoReissue": "enable",
  "AutoReissueFlag": 1,
  "AverageWaitingTime": "120",
  "Brand": "DigiCert",
  "CertIdentifier": "22783111-cn-hangzhou",
  "CertificateId": 1234567890,
  "CertificateName": "123",
  "CertificateNotAfter": 1801324800000,
  "CertificateNotBefore": 1781568000000,
  "CertificateRevokeTime": 1801324800000,
  "CertificateStatus": "issued",
  "CertificateType": "DV",
  "City": "Beijing",
  "CompanyId": 47305,
  "ContactIdList": [
    123
  ],
  "CountryCode": "CN",
  "Csr": "-----BEGIN CERTIFICATE REQUEST-----   ...... -----END CERTIFICATE REQUEST-----",
  "DeploymentResourceCount": 30,
  "DeploymentUseCount": 30,
  "DingGroupList": [
    {
      "DingGroupInstanceId": "123",
      "DingGroupName": "123",
      "DingGroupType": "remote",
      "DingGroupUrl": "https://123.com"
    }
  ],
  "Domain": "example.com",
  "DomainValidationList": [
    {
      "Cname": "123.com",
      "CnameKey": "abc",
      "Domain": "example.com",
      "RootDomain": "example.com",
      "ValidationKey": "@",
      "ValidationType": "TXT",
      "ValidationValue": "123"
    }
  ],
  "FullDomainCount": 1,
  "GenerateCsrMethod": "online",
  "InstanceEndTime": 1801324800000,
  "InstanceId": "cas_dv-cn-123",
  "InstanceStartTime": 1801324800000,
  "InstanceType": "TEST",
  "KeyAlgorithm": "RSA_2048",
  "MonitorExpandFlag": 1,
  "MonitorUseCount": 10,
  "OrderEndTime": 1801324800000,
  "OrderStartTime": 1801324800000,
  "PendingResult": "pending",
  "Province": "Beijing",
  "RequestId": "B2CE1D02-6D5E-56E5-A9BD-EE288255C7F9",
  "ResourceGroupId": "rg-aek****wia",
  "Spec": "ss.dv.t",
  "Status": "inactive",
  "Tags": [
    {
      "TagKey": "test",
      "TagValue": "test"
    }
  ],
  "TotalDeploymentCount": 60,
  "TotalMonitorCount": 80,
  "UpgradeStatus": "none",
  "ValidationMethod": "DNS",
  "VersionType": "0",
  "WildcardDomainCount": 0
}

    エラーコード

    完全なリストについては、「エラーコード」をご参照ください。

    変更履歴

    完全なリストについては、「変更履歴」をご参照ください。