Trust Anchorの照会

Prev Next

Classic/VPC環境で利用できます。

Trust Anchor情報を照会します。

リクエスト

リクエスト形式を説明します。 リクエスト形式は次の通りです。

メソッド URI
GET /api/v1/trust-anchors/{trustAnchorId}

リクエストヘッダ

Sub Account APIで共通して使用されるヘッダの詳細は、Sub Accountのリクエストヘッダをご参照ください。

リクエストパスパラメータ

リクエストパスパラメータの説明は次の通りです。

フィールド タイプ 必須の有無 説明
trustAnchorId String Required Trust Anchor ID

リクエスト例

リクエストのサンプルコードは次の通りです。

curl --location --request GET 'https://externalaccess.apigw.ntruss.com/api/v1/trust-anchors/a271f5b5-****-****-****-bda95123e58e' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Accept: application/json'

レスポンス

レスポンス形式を説明します。

レスポンスボディ

レスポンスボディの説明は次の通りです。

フィールド タイプ 必須の有無 説明
trustAnchorId String - Trust Anchor ID
trustAnchorNrn String - Trust Anchorに対する NAVERクラウドプラットフォームリソースの識別値
name String - Trust Anchor名
description String - Trust Anchorの説明
enabled Boolean - 状態
  • true | false
    • true: 有効化
    • false: 無効化
createTime String - 作成日時
  • ISO 8601形式
updateTime String - 最終更新日時
  • ISO 8601形式
source Object - CA情報
source.sourceType String - CAタイプ
  • NCP_PCA | CERTIFICATE_BUNDLE
    • NCP_PCA: NAVERクラウドプラットフォームの Private CAを使用する場合
    • CERTIFICATE_BUNDLE: ユーザーが外部で作成した CAを使用する場合
source.sourceData Object - CA対象情報
source.sourceData.caId Integer - NAVERクラウドプラットフォーム Private CAの ID
  • sourceType: NCP_PCAの場合
source.sourceData.nrn String - CAに対する NAVERクラウドプラットフォームリソースの識別値
  • sourceType: NCP_PCAの場合
source.sourceData.notAfterDate String - Trust Anchorに連携されている CAの有効期限
  • ISO 8601形式
source.sourceData.x509CertificateData String - Trust Anchorに連携されている CA証明書データ
  • PEM形式

レスポンスステータスコード

Sub Account APIで共通して使用されるレスポンスステータスコードの詳細は、Sub Accountのレスポンスステータスコードをご参照ください。

レスポンス例

レスポンスのサンプルコードは次の通りです。

  • source.sourceTypeが NCP_PCAの場合

    {
    "trustAnchorId": "a271f5b5-****-****-****-bda95123e58e",
    "trustAnchorNrn": "nrn:PUB:ExternalAccess::*******:TrustAnchor/a271f5b5-****-****-****-bda95123e58e",
    "name": "ta000",
    "description": "test",
    "enabled": false,
    "createTime": "2024-12-13T13:16:50.331+09:00",
    "updateTime": "2024-12-13T13:16:50.331+09:00",
    "source": {
        "sourceType": "NCP_PCA",
        "sourceData": {
            "caId": *****,
            "nrn": "nrn:PUB:PrivateCA::*******:CA/*****",
            "notAfterDate": "2025-12-13T13:15:57",
            "x509CertificateData": "-----BEGIN CERTIFICATE-----\n{CA}\n-----END CERTIFICATE-----"
        }
    }
}

  • source.sourceTypeが CERTIFICATE_BUNDLEの場合

    {
    "trustAnchorId": "a271f5b5-****-****-****-bda95123e58e",
    "trustAnchorNrn": "nrn:PUB:ExternalAccess::*******:TrustAnchor/a271f5b5-****-****-****-bda95123e58e",
    "name": "ta000",
    "description": "test",
    "enabled": false,
    "createTime": "2024-12-13T13:16:50.331+09:00",
    "updateTime": "2024-12-13T13:16:50.331+09:00",
    "source": {
        "sourceType": "CERTIFICATE_BUNDLE",
        "sourceData": {
            "notAfterDate": "2025-12-13T13:15:57",
            "x509CertificateData": "-----BEGIN CERTIFICATE-----\n{CA}\n-----END CERTIFICATE-----"
        }
    }
}