CoreStack Tagging Governance Postures API

openapi: 3.2.0
info:
  title: CoreStack External Tagging Governance Postures API
  version: 1.0.0
  termsOfService: http://corestack.io/
  license:
    name: CoreStack Inc License
    url: http://corestack.io/licenses/LICENSE-2.0.html
  description: Manage Tagging Governance Postures
servers:
- url: /
tags:
- name: TaggingGovernancePostures
  description: Manage Tagging Governance Postures
paths:
  /v1/tag_posture/snapshot/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureSnapshotBatchResponse'
      summary: Returns a batch of TagPostureSnapshot
      description: Get details for the snapshot ids passed in the request
      operationId: SnapshotBatch
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/tag_posture/snapshot/create:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureSnapshot'
      summary: Returns a TagPostureSnapshot
      description: Create a new snapshot. This will generate the tag posture with the currently active baselines. Old snapshots will be cleaned up based on the 'keep' parameter
      operationId: SnapshotCreate
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSnapshotCreateRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/resource/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureResourceBatchResponse'
      summary: Returns a batch of TagPostureResources
      description: For a given snapshot, get the details of the requested resources
      operationId: ResourceBatch
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureResourceBatchRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/resource/item/{resource_id}:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureResource'
      summary: Returns a TagPostureResource based on input filters
      description: Get posture details for a particular resource.
      operationId: ResourceGet
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: Snapshot to use for evaluating baselines ("live" computes the posture on demand)
        schema:
          type: string
      - name: resource_id
        in: path
        required: true
        description: ID of resource to fetch
        schema:
          type: string
      - description: Baseline to evaluate resource against (all if missing)
        in: query
        name: baseline_id
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
  /v1/tag_posture/snapshot/item/{snapshot_id}/resource_summary:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureResourceCoverage'
      summary: Summarize the tag posture matching the filtering criteria returning resource coverage counts
      description: For a given snapshot, list all of the posture summaries for resources. Allows filtering and sorting based on the request
      operationId: ResourceSummary
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSummaryListRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/summary/cloud_account/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureCloudAccountSummaryBatchResponse'
      summary: Returns a batch of TagPostureCloudAccountSummary
      description: For a given snapshot, get the details of the requested cloud account posture summaries
      operationId: CloudAccountSummaryBatch
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      - description: Baseline to fetch summary for (all if missing)
        in: query
        name: baseline_id
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/summary/cloud_account/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse'
      summary: Returns a list of TagPostureCloudAccountSummary identifiers based on input filters
      description: For a given snapshot, list all of the posture summaries for cloud accounts. Allows filtering and sorting based on the request
      operationId: CloudAccountSummaryList
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSummaryListRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/summary/resource/batch:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureResourceSummaryBatchResponse'
      summary: Returns a batch of TagPostureResourceSummary
      description: For a given snapshot, get the details of the requested resource posture summaries
      operationId: ResourceSummaryBatch
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      - description: Baseline to fetch summary for (all if missing)
        in: query
        name: baseline_id
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/BatchRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/summary/resource/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse'
      summary: Returns a list of TagPostureResourceSummary identifiers based on input filters
      description: For a given snapshot, list all of the posture summaries for resources. Allows filtering and sorting based on the request
      operationId: ResourceSummaryList
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSummaryListRequest'
        required: true
  /v1/tag_posture/snapshot/item/{snapshot_id}/workload_summary/{workload_id}:
    get:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/TagPostureWorkloadCloudSummaryResponse'
      summary: Get a TagPostureSummary for Workload
      description: For a given snapshot, get the details of the requested workload cloud posture summaries
      operationId: TagPostureWorkloadSummary
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of Snapshot
        schema:
          type: string
      - name: workload_id
        in: path
        required: true
        description: ID of Workload
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
  /v1/tag_posture/snapshot/item/{snapshot_id}/workload_summary/{workload_id}/resource/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse'
      summary: Returns a batch of TagPostureWorkloadResourceSummary
      description: For a given snapshot, get the details of the requested workload resource posture summaries
      operationId: WorkloadResourceSummaryList
      parameters:
      - name: snapshot_id
        in: path
        required: true
        description: ID of snapshot
        schema:
          type: string
      - name: workload_id
        in: path
        required: true
        description: ID of Workload
        schema:
          type: string
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSummaryListRequest'
        required: true
  /v1/tag_posture/snapshot/list:
    post:
      responses:
        '500':
          description: Internal Server Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ModelError'
        '200':
          description: Generated
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListResponse'
      summary: Returns a list of TagPostureSnapshot ids
      description: Get the list of all Tag Posture Snapshot. Each snapshot represents the tag posture generated at a particular time with a set of baselines.
      operationId: SnapshotList
      security:
      - auth_token: []
      tags:
      - TaggingGovernancePostures
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/TagPostureSnapshotListRequest'
        required: true
components:
  schemas:
    TagPostureWorkloadCloudSummary:
      properties:
        workload_id:
          type: string
          description: Workload id
        workload_cloud_summary:
          type: array
          description: Workload Cloud Tag Posture Summary
          items:
            $ref: '#/components/schemas/TagPostureCloudAccountSummary'
      type: object
    TagBaselineReference:
      properties:
        baseline_id:
          type: string
        baseline_version_id:
          type: string
      type: object
    TagPostureResourceSummaryBatchResponse:
      properties:
        results:
          type: object
          description: Map from identifier to response model
          additionalProperties:
            $ref: '#/components/schemas/TagPostureResourceSummary'
      type: object
    TagPostureContext:
      properties:
        filter:
          $ref: '#/components/schemas/AccountFilters'
        baseline_id:
          type: string
          description: Only return postures for the selected baseline
        resource_categories:
          type: array
          description: Resource categories to filter (all if missing)
          items:
            type: string
        resource_components:
          type: array
          description: Resource components to filter (all if missing)
          items:
            type: string
        resource_types:
          type: array
          description: Resources types to filter (all if missing)
          items:
            type: string
        resources:
          type: array
          description: Resources to filter (all if missing)
          items:
            type: string
        supports_remediation_only:
          type: boolean
          description: Whether to only return resources that support remediation
        text_query:
          type: string
          description: Text query for tag postures
        workload_id:
          type: string
          description: Workload Id
        is_billable:
          type: array
          description: Whether to only return billable/non billable resources)
          items:
            type: boolean
        tag_key:
          type: string
          description: Tag key to filter resources by, used to evaluate governance coverage for a specific tag like 'owner' or 'environment'.
      type: object
    TagPostureResourceBatchResponse:
      properties:
        results:
          type: object
          description: Map from identifier to response model
          additionalProperties:
            $ref: '#/components/schemas/TagPostureResource'
      type: object
    TagPostureSnapshotBatchResponse:
      properties:
        results:
          type: object
          description: Map from identifier to response model
          additionalProperties:
            $ref: '#/components/schemas/TagPostureSnapshot'
      type: object
    TagPostureSnapshotSortCriteria:
      required:
      - column
      properties:
        column:
          type: string
          example: CreatedAt
          enum:
          - CreatedAt
          - Status
          - Reason
          x-cs-enum-type: TagPostureSnapshotSortColumn
        ascending:
          type: boolean
      type: object
    AccountFilters:
      properties:
        tenants:
          type: array
          description: Tenants to include (all if missing)
          items:
            type: string
        clouds:
          type: array
          description: Cloud Providers to include (all if missing)
          items:
            type: string
            description: Cloud Provider to select
            example: AWS
            enum:
            - AWS
            - Azure
            - AzureStack
            - Azure_CSP
            - Azure_CSP-Direct
            - Azure_EA
            - Azure_MCA
            - Cloudstack
            - GCP
            - MS_VMM
            - OCI
            - Openstack
            - PrivateCloud
            - Rackspace
            - VMware
            - VMware_VCD
            - vCenter
            x-cs-enum-type: CloudServiceName
        cloud_accounts:
          type: array
          description: Cloud Accounts to include (all if missing)
          items:
            type: string
        regions:
          type: array
          description: Regions to include (all if missing)
          items:
            type: string
        resource_filter:
          type: array
          description: Resources filter to filter (all if missing)
          items:
            type: string
        product_categories:
          type: array
          description: Product Categories to include (all if missing)
          items:
            type: string
        category:
          type: string
          description: Inventory Category of the resources to filter (all if missing)
        resource_type:
          type: array
          description: Type of Resources to include (all if missing)
          items:
            type: string
      type: object
    TagPostureCloudAccountSummary:
      allOf:
      - $ref: '#/components/schemas/TagPostureBase'
      - properties:
          created_at:
            type: string
            format: date-time
            description: Time coverage was generated
          cloud_account_name:
            type: string
            description: Name of cloud account
          resource_coverage:
            description: Resource coverage of the posture
            $ref: '#/components/schemas/TagPostureResourceCoverage'
          tag_coverage:
            type: array
            description: Tag level coverage for the posture
            items:
              $ref: '#/components/schemas/TagPostureTagCoverage'
          baselines:
            type: array
            description: List of baselines that are included in this snapshot for this account
            items:
              $ref: '#/components/schemas/TagBaselineReference'
          remediation_allowed:
            type: boolean
            description: Whether tag remediation is allowed for this account
        type: object
      x-cs-type-name: TagPostureCloudAccountSummary
    TagPostureSummaryCount:
      properties:
        valid_count:
          type: integer
          description: Number of valid
        invalid_count:
          type: integer
          description: Number of invalid
        missing_keys_count:
          type: integer
          description: Number of missing
        auto_suggested_count:
          type: integer
          description: Number of suggestions
      type: object
    TagPostureSnapshot:
      properties:
        snapshot_id:
          type: string
        account_id:
          type: string
          description: Id of the account associated with the snapshot
        created_at:
          type: string
          format: date-time
          description: When the snapshot was created
        updated_at:
          type: string
          format: date-time
          description: When the snapshot was updated
        created_by:
          type: string
          description: User ID of user who created the snapshot
        status:
          type: string
          description: Status of the snapshot
          example: Running
          enum:
          - Running
          - Failed
          - Success
          x-cs-enum-type: TagPostureSnapshotStatus
        reason:
          type: string
          description: Reason for triggering the snapshot
          example: Manual
          enum:
          - Manual
          - Automatic
          x-cs-enum-type: TagPostureSnapshotReason
        progress:
          description: Progress of the generation
          $ref: '#/components/schemas/TagPostureSnapshotProgress'
      type: object
    TagPostureCloudAccountSummaryBatchResponse:
      properties:
        results:
          type: object
          description: Map from identifier to response model
          additionalProperties:
            $ref: '#/components/schemas/TagPostureCloudAccountSummary'
      type: object
    TagPostureResourceBatchRequest:
      properties:
        baseline_id:
          type: string
          description: Baseline to fetch summary for (all if missing)
        resource_ids:
          type: array
          description: List of resource ids to fetch Tag Posture Details
          items:
            type: string
      type: object
    ModelError:
      required:
      - message
      properties:
        message:
          type: string
          description: Error response message.
      type: object
    TagPostureBase:
      required:
      - __type
      properties:
        account_id:
          type: string
          description: Id of the CoreStack Account under which this tenant resides
        tenant_id:
          type: string
          description: Id of the CoreStack Tenant for the posture
        cloud:
          type: string
          description: Cloud Provider being summarized
          example: AWS
          enum:
          - AWS
          - Azure
          - AzureStack
          - Azure_CSP
          - Azure_CSP-Direct
          - Azure_EA
          - Azure_MCA
          - Cloudstack
          - GCP
          - MS_VMM
          - OCI
          - Openstack
          - PrivateCloud
          - Rackspace
          - VMware
          - VMware_VCD
          - vCenter
          x-cs-enum-type: CloudServiceName
        cloud_account_id:
          type: string
          description: Cloud Account id for the posture
      discriminator:
        propertyName: __type
      type: object
      x-cs-subtypes:
      - subtype_model: TagPostureCloudAccountSummary
        subtype_name: TagPostureCloudAccountSummary
      - subtype_model: TagPostureResourceBase
        subtype_name: TagPostureResourceBase
      - subtype_model: TagPostureResourceSummary
        subtype_name: TagPostureResourceSummary
      - subtype_model: TagPostureResource
        subtype_name: TagPostureResource
    TagPostureSnapshotProgress:
      properties:
        total_cloud_accounts:
          type: integer
          description: Total number of cloud accounts in the snapshot
        processed_cloud_accounts:
          type: integer
          description: Number of cloud accounts that have been processed already
      type: object
    TagPostureResourceSummary:
      allOf:
      - $ref: '#/components/schemas/TagPostureResourceBase'
      - properties:
          supports_remediation:
            type: boolean
            description: Whether or not the resource supports remediation
          resource_coverage:
            description: Resource coverage of the posture
            $ref: '#/components/schemas/TagPostureResourceCoverage'
          is_billable:
            type: array
            description: Whether to only return billable/non billable resources)
            items:
              type: boolean
        type: object
      x-cs-type-name: TagPostureResourceSummary
    TagPostureTagDetails:
      properties:
        tag:
          type: string
          description: Tag key
        value:
          type: string
          description: Value of tag
        is_valid:
          type: boolean
          description: Whether the tag is valid
        auto_suggest:
          type: array
          description: Possible values for the key
          items:
            type: string
      type: object
    TagPostureTagCoverage:
      properties:
        tag:
          type: string
          description: Tag key
        resource_counts:
          description: Counts of resources for this tag
          $ref: '#/components/schemas/TagPostureSummaryCount'
      type: object
    ListContext:
      properties:
        batch_size:
          type: integer
          description: Max number of ids in the response
        batch_offset:
          type: integer
          description: Offset of batches into the results. First batch is 0
        total:
          type: integer
          description: Total number of results
      type: object
    TagPostureResourceCoverage:
      properties:
        resource_count:
          type: integer
          description: Total number of resources
        valid_resource_count:
          type: integer
          description: Number of resources with 100% coverage
        tag_counts:
          description: Count of tags for all resources
          $ref: '#/components/schemas/TagPostureSummaryCount'
        missing_tag_keys:
          type: array
          description: List of missing tag keys
          items:
            type: string
        invalid_tag_values:
          type: object
          description: Map of invalid tag values
          additionalProperties:
            type: string
      type: object
    TagPostureWorkloadCloudSummaryResponse:
      properties:
        results:
          type: object
          description: Map from identifier to response model
          additionalProperties:
            $ref: '#/components/schemas/TagPostureWorkloadCloudSummary'
      type: object
    TagPostureSummarySortCriteria:
      required:
      - column
      properties:
        column:
          type: string
          example: Cloud
          enum:
          - Cloud
          - CloudAccountName
          - CloudResourceId
          - InvalidTags
          - MissingTags
          - ResourceCategory
          - ResourceComponent
          - ResourceCoverage
          - ResourceName
          - ResourceRegion
          - ResourceType
          - ResourceFilter
          - TagCoverage
          x-cs-enum-type: TagPostureSummarySortColumn
        ascending:
          type: boolean
      type: object
    BatchRequest:
      properties:
        ids:
          type: array
          description: Identifiers to fetch
          items:
            type: string
      type: object
    ListResponse:
      properties:
        results:
          type: array
          description: List of result identifiers
          items:
            type: string
        next_list_context:
          description: List context
          $ref: '#/components/schemas/ListContext'
      type: object
    TagPostureSnapshotCreateRequest:
      properties:
        cloud_account_ids:
          type: array
          description: List of cloud account ids to include in the snapshot
          items:
            type: string
      type: object
    TagPostureSummaryListRequest:
      properties:
        list_context:
          description: Optional list context
          $ref: '#/components/schemas/ListContext'
        sort:
          type: array
          description: Sort criteria
          items:
            $ref: '#/components/schemas/TagPostureSummarySortCriteria'
        filter

# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/corestack/refs/heads/main/openapi/corestack-tagginggovernancepostures-api-openapi.yml