ClusterApplicationResources DATASOURCE リソースリファレンス - ROS

DATASOURCE::CS::ClusterApplicationResources は、Container Service for Kubernetes（ACK）クラスタ内の指定されたタイプのリソースに関する情報をクエリするために使用されます。

構文

{
  "Type": "DATASOURCE::CS::ClusterApplicationResources",
  "Properties": {
    "ApiVersion": String,
    "FirstMatch": Boolean,
    "ClusterId": String,
    "Kind": String,
    "JsonPath": String,
    "Namespace": String,
    "Name": String,
    "RefreshOptions": String
  }
}

プロパティ

プロパティ	タイプ	必須	編集可能	説明	制約
ClusterId	String	はい	いいえ	クラスタ ID。	なし。
Kind	String	はい	はい	クラスタ内でクエリするリソースのタイプ。	有効な値: ConfigMap Service PodTemplate Namespace Secret Node ComponentStatus ReplicationController LimitRange ResourceQuota PersistentVolumeClaim ServiceAccount PersistentVolume Endpoints Binding Pod Event
Name	String	いいえ	はい	クラスタ名。	なし。
Namespace	String	いいえ	はい	クラスタが属する名前空間。	なし。
JsonPath	String	いいえ	はい	結果をフィルタリングするために使用する JSONPath 式。	なし。
FirstMatch	Boolean	いいえ	はい	JSONPath 式を使用してフィルタリングされた結果で、最初に一致した結果のみを返すかどうかを指定します。	有効な値: true false (デフォルト)
ApiVersion	String	いいえ	はい	API バージョン。	なし。
RefreshOptions	String	いいえ	はい	スタックが更新されたときのデータソースリソースの更新ポリシー。	有効な値: Never (デフォルト): スタックが更新されたときにデータソースリソースを更新しません。 Always: スタックが更新されたときにデータソースリソースを更新します。

戻り値 (Fn::GetAtt)

Response: クラスタ内でクエリされたリソースのコレクション。

プロパティ	タイプ	説明	制約
metadata	Map	クラスタ内のリソースのメタデータ。	例: `{"resourceVersion": "254****"}`
apiVersion	String	API バージョン。	例: v1。
kind	String	クラスタ内でクエリされたリソースのタイプ。	有効な値: ConfigmapList ServiceList PodTemplateList Namespace SecretList NodeList ComponentStatusList ReplicationControllerList LimitRangeList ResourceQuotaList PersistentVolumeClaimList ServiceAccountList PersistentVolumeList EndpointsList BindingList PodList EventList
items	List	クラスタ内のリソースの詳細。	このプロパティは、Name が指定されていない場合にのみ返されます。例: [ { "metadata": { "uid": "5a3d04e1-8a72-4566-b435-af56f77f**", "managedFields": [ { "apiVersion": "v1", "fieldsV1": { "f:data": { "f:ca.crt": {}, ".": {} }, "f:metadata": { "f:annotations": { "f:kubernetes.io/description": {}, ".": {} } } }, "manager": "kube-controller-manager", "time": "2022-11-02T04:03:08Z", "operation": "Update", "fieldsType": "FieldsV1" } ], "resourceVersion": "254", "namespace": "default", "creationTimestamp": "2022-11-02T04:03:08Z", "name": "kube-root-ca.crt", "annotations": { "kubernetes.io/description": "Contains a CA bundle that can be used to verify the kube-apiserver when using internal endpoints such as the internal service IP or kubernetes.default.svc. No other usage is guaranteed across distributions of Kubernetes clusters." } }, "apiVersion": "v1", "data": { "ca.crt": "-----BEGIN CERTIFICATE-----\nMIIDTjCCAjagAwIBAgIUZvaXvIyXCj7R1q7UgYKPmO+D4lgwDQYJKoZIhvcN\nBQAwPjEnMA8GA1UEChMIaGFuZ3pob3UwFAYDVQQKEw1hbGliYWJhIGNsb3Vk\nEQYDVQQDEwprdWJlcm5ldGVzMCAXDTIyMTEwMjAzNTgwMFoYDzIwNTIxMDI1\nODAwWjA+MScwDwYDVQQKEwhoYW5nemhvdTAUBgNVBAoTDWFsaWJhYmEgY2xv\nEzARBgNVBAMTCmt1YmVybmV0ZXMwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAw\nAoIBAQDXEuGvRudCTo7FJoyQCBvfG2Zx+F+htG8/doyE6LjW7o2lxejs\nz/3QO4hzVpNsicdBlNNwzPyykKDoxgAXE8HLL5P/RyE6CiANzG6qQRPE\nKm9G88XdXnPsaYEwRAskPmnifR04Ofqp0d4tSAEYoMgLFIjfOhFezrhDNYQw\nAr0H77bwse5PABcHtbZ3JIZlV7ArluH4FMHAqw4YWq71EgPxooRmqWxH7nOI\nVTCfaJ5Jtxc2iuDlmIgODrpYyweoIxs7oIgXgDJT8/RZ0DOv2WEfzeTuuBYFE+fi\nkk+5WFy0WIIZkrc7KhZdru096rD1AgMBAAGjQjBAMA4GA1UdDwEB/wQEAwIC\nBgNVHCNYAf8EBTADAQH/MB0GA1UdDgQWBBTPFeL0s4fc/uMRdLkkBpbyCYlb\nBgkqhkiG9w0BAQsFAAOCAQEAFknCC6c7Y8aO8UEgC8e+y7oVuQokV2e+UhzM\nryHO3XTPhE1paIaKsY70u2OgRHxqhQuuVm8pJbAXcKigXzK0tRcrS94p\nQhNbiVsrZjws49Vy5iTigRhejiyIauS2qXwbq4Fh4miOM7cu02cXT58kdunR\naS29Vzz9NeZXTCrUY19jkVoKIFVQpldyNJt/012SY044scejeba5/MsUPc01\nPddEJLx5TuZb16K48qvSkGv1fJFNA/Dia61T4EDHRobcDU6ge2o6nSCy7AoX\nDbHv5QxY7mhn1DJFJFzY13Ep/5xXUH5ZDtbY4vMyWio1**\n-----END CERTIFICATE-----\n" }, "kind": "ConfigMap" } ]

例

次のセクションでは、DATASOURCE::CS::ClusterApplicationResources を使用して、ACK クラスタ内の ConfigMap タイプのリソースをクエリする方法の例を示します。

`JSON` 形式

{
  "ROSTemplateFormatVersion": "2015-09-01",
  "Parameters": {
    "ClusterId": {
      "Type": "String",
      "Description": "Kubernetes クラスタの ID。"
    },
    "Kind": {
      "Type": "String",
      "Description": "クエリする Kubernetes リソース の種類。",
      "Default": "ConfigMap",
      "AllowedValues": [
        "ConfigMap",
        "Service",
        "PodTemplate",
        "Namespace",
        "Secret",
        "Node",
        "ComponentStatus",
        "ReplicationController",
        "LimitRange",
        "ResourceQuota",
        "PersistentVolumeClaim",
        "ServiceAccount",
        "PersistentVolume",
        "Endpoints",
        "Binding",
        "Pod",
        "Event"
      ]
    }
  },
  "Resources": {
    "ClusterApplicationResources": {
      "Type": "DATASOURCE::CS::ClusterApplicationResources",
      "Properties": {
        "ClusterId": {
          "Ref": "ClusterId"
        },
        "Kind": {
          "Ref": "Kind"
        }
      }
    }
  },
  "Outputs": {
    "Response": {
      "Description": "Kubernetes リソース のクエリ結果。",
      "Value": {
        "Fn::GetAtt": [
          "ClusterApplicationResources",
          "Response"
        ]
      }
    }
  }
}

`YAML` 形式

ROSTemplateFormatVersion: '2015-09-01'
Parameters:
  ClusterId:
    Type: String
    Description: Kubernetes クラスタの ID。
  Kind:
    Type: String
    Description: クエリする Kubernetes リソース の種類。
    Default: ConfigMap
    AllowedValues:
      - ConfigMap
      - Service
      - PodTemplate
      - Namespace
      - Secret
      - Node
      - ComponentStatus
      - ReplicationController
      - LimitRange
      - ResourceQuota
      - PersistentVolumeClaim
      - ServiceAccount
      - PersistentVolume
      - Endpoints
      - Binding
      - Pod
      - Event
Resources:
  ClusterApplicationResources:
    Type: DATASOURCE::CS::ClusterApplicationResources
    Properties:
      ClusterId:
        Ref: ClusterId
      Kind:
        Ref: Kind
Outputs:
  Response:
    Description: Kubernetes リソース のクエリ結果。
    Value:
      Fn::GetAtt:
        - ClusterApplicationResources
        - Response

構文

プロパティ

戻り値 (Fn::GetAtt)

例

JSON 形式

YAML 形式

`JSON` 形式

`YAML` 形式