ドキュメント
ホームページ Certificate Management Service 開発者リソース APIリファレンス (プライベート証明書) フロー制御情報 その他 DescribeClientCertificateForSerialNumber

DescribeClientCertificateForSerialNumber

更新日時
Copy as MD
製品

複数のクライアント証明書またはサーバー証明書の詳細をシリアル番号で照会します。

説明

この API は廃止されました。一時的にアクセス可能ですが、更新やバグ修正対応は一切行われません。代わりに cas(2020-06-30) - DescribeClientCertificate への移行を推奨します。より強化された機能に加え、サポートも引き続きご利用いただけます。

操作説明

使用方法

この操作を使用して、複数のクライアント証明書またはサーバー証明書のシリアル番号の詳細を照会します。応答には、各証明書のシリアル番号、主題、内容、ステータスなどの詳細が含まれます。

この操作を呼び出す前に、クライアント証明書またはサーバー証明書が作成済みであることを確認してください。

クライアント証明書を作成するには、以下をご参照ください。

サーバー証明書を作成するには、以下をご参照ください。

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:DescribeClientCertificateForSerialNumber

get

*All Resource

*

 なし なし

リクエストパラメーター

パラメーター

型

必須 / 任意

説明

例
SerialNumber

string

必須

クライアント証明書またはサーバー証明書のシリアル番号。複数のシリアル番号はコンマで区切ります。

説明

ListClientCertificate を呼び出して、すべてのクライアント証明書とサーバー証明書のシリアル番号を照会します。

084bde9cd233f0ddae33adc438cfbbbd****

この API を呼び出す際は、このトピックで説明されている API 固有のパラメーターに加えて、Alibaba Cloud の共通リクエストパラメーターを含める必要があります。詳細については、「共通パラメーター」をご参照ください。

リクエスト形式については、[例] セクションの例をご参照ください。

レスポンスフィールド

フィールド

型

説明

例

object

ListCertificateResponse

CertificateList

array<object>

クライアント証明書またはサーバー証明書の詳細。

object

証明書情報。

X509Certificate

string

証明書の内容。

-----BEGIN CERTIFICATE----- ...... -----END CERTIFICATE-----
Identifier

string

証明書の一意の識別子。

d3b95700998e47afc4d95f886579****
SerialNumber

string

証明書のシリアル番号。

084bde9cd233f0ddae33adc438cfbbbd****
SubjectDN

string

証明書の識別名 (DN)。DN には、証明書の主題に関する情報が含まれます。

  • C：国。

  • O：組織。

  • OU：組織単位。

  • L：都市。

  • ST：州または都道府県。

  • CN：共通名。

C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun
CommonName

string

証明書の共通名。

aliyun.com
OrganizationUnit

string

発行者の組織単位。

Security
Organization

string

発行者の組織。

阿里云计算有限公司
Locality

string

発行者の都市。

Hangzhou
State

string

発行者の州または都道府県。

Zhejiang
CountryCode

string

発行者の 2 文字の国別コード。

国別コードの詳細については、「会社プロファイルの管理」の [国別コード] セクションをご参照ください。

CN
Sans

string

メールアドレス、ドメイン名、URI、IP アドレスなどの識別子を指定するサブジェクト代替名 (SAN) 拡張。

SAN オブジェクトの配列を表す JSON 文字列。各オブジェクトには、次のパラメーターが含まれます。

  • Type：拡張のタイプ。このパラメーターは整数です。有効な値:

    • 1：メールアドレス。

    • 2：ドメイン名。

    • 6：Uniform Resource Identifier (URI)。

    • 7：IP アドレス。

  • Value：拡張の内容。このパラメーターは文字列です。

[ {"Type": 7, "Value": "192.0.XX.XX"}, {"Type": 2, "Value": "www.aliyundoc.com"}, ]
Status

string

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

  • ISSUE：証明書が発行済み。

  • REVOKE：証明書が取り消し済み。

ISSUE
BeforeDate

string

証明書の発行時刻。

2021-10-28T16:15Z
AfterDate

string

証明書の有効期限。

2022-08-23T16:15Z
Algorithm

string

証明書の暗号化アルゴリズム。有効な値:

  • RSA：RSA アルゴリズム。

  • ECC：ECC アルゴリズム。

  • SM2：SM2 アルゴリズム。

RSA
KeySize

integer

証明書のキー長。

4096
SignAlgorithm

string

証明書の署名アルゴリズム。

SHA256WITHRSA
CertificateType

string

証明書のタイプ。

SUB_ROOT
ParentIdentifier

string

発行者の識別子。このパラメーターは、証明書が Alibaba Cloud によって発行された場合にのみ返されます。

1a83bcbb89e562885e40aa0108f5****
Sha2

string

証明書の SHA-256 指紋。

14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****
Md5

string

証明書の MD5 指紋。

d3b95700998e47afc4d95f886579****
Years

integer

このパラメーターは非推奨です。

1
RequestId

string

リクエストの ID。

15C66C7B-671A-4297-9187-2C4477247A74

例

成功レスポンス

JSONJSON

{
  "CertificateList": [
    {
      "X509Certificate": "-----BEGIN CERTIFICATE-----  ...... -----END CERTIFICATE-----",
      "Identifier": "d3b95700998e47afc4d95f886579****",
      "SerialNumber": "084bde9cd233f0ddae33adc438cfbbbd****",
      "SubjectDN": "C=CN,O=阿里云计算有限公司,OU=Security,L=Hangzhou,ST=Zhejiang,CN=Aliyun",
      "CommonName": "aliyun.com",
      "OrganizationUnit": "Security",
      "Organization": "阿里云计算有限公司",
      "Locality": "Hangzhou",
      "State": "Zhejiang",
      "CountryCode": "CN",
      "Sans": "[ {\"Type\": 7, \"Value\": \"192.0.XX.XX\"}, {\"Type\": 2, \"Value\": \"www.aliyundoc.com\"}, ]",
      "Status": "ISSUE",
      "BeforeDate": "2021-10-28T16:15Z",
      "AfterDate": "2022-08-23T16:15Z",
      "Algorithm": "RSA",
      "KeySize": 4096,
      "SignAlgorithm": "SHA256WITHRSA",
      "CertificateType": "SUB_ROOT",
      "ParentIdentifier": "1a83bcbb89e562885e40aa0108f5****",
      "Sha2": "14dcc8afc7578e1fcec36d658f7e20de18f6957bbac42b373a66bc9de4e9****",
      "Md5": "d3b95700998e47afc4d95f886579****",
      "Years": 1
    }
  ],
  "RequestId": "15C66C7B-671A-4297-9187-2C4477247A74"
}

エラーコード

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

変更履歴

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

前へ：AssignCertificateCount次へ：DescribeClientCertificateStatusForSerialNumber