openapi: 3.2.0 info: title: 'Automation Hub Remotes: Git API' version: v3 description: Fetch, Upload, Organize, and Distribute Ansible Collections contact: name: Automation Hub Team email: ansible-galaxy-team@redhat.com url: https://www.ansible.com/products/automation-hub license: name: GPLv2+ url: https://raw.githubusercontent.com/ansible/galaxy_ng/main/LICENSE x-logo: url: https://pulp.plan.io/attachments/download/517478/pulp_logo_word_rectangle.svg x-pulp-app-versions: core: 3.49.40 galaxy: 4.12.0dev ansible: 0.25.1 container: 2.19.5 certguard: 3.49.40 file: 3.49.40 x-pulp-domain-enabled: false servers: - url: http://automation-hub-backend-cwa.automation-hub-prod.svc.cluster.local:8000/ tags: - name: 'Remotes: Git' paths: /api/automation-hub/pulp/api/v3/remotes/ansible/git/: get: operationId: remotes_ansible_git_list description: 'ViewSet for Ansible Remotes. This is a tech preview feature. The functionality may change in the future.' summary: List git remotes parameters: - name: limit required: false in: query description: Number of results to return per page. schema: type: integer - in: query name: name schema: type: string description: Filter results where name matches value - in: query name: name__contains schema: type: string description: Filter results where name contains value - in: query name: name__icontains schema: type: string description: Filter results where name contains value - in: query name: name__iexact schema: type: string description: Filter results where name matches value - in: query name: name__in schema: type: array items: type: string description: Filter results where name is in a comma-separated list of values explode: false style: form - in: query name: name__iregex schema: type: string description: Filter results where name matches regex value - in: query name: name__istartswith schema: type: string description: Filter results where name starts with value - in: query name: name__regex schema: type: string description: Filter results where name matches regex value - in: query name: name__startswith schema: type: string description: Filter results where name starts with value - name: offset required: false in: query description: The initial index from which to return the results. schema: type: integer - in: query name: ordering schema: type: array items: type: string enum: - -ca_cert - -client_cert - -client_key - -connect_timeout - -download_concurrency - -headers - -max_retries - -name - -password - -pk - -policy - -proxy_password - -proxy_url - -proxy_username - -pulp_created - -pulp_id - -pulp_labels - -pulp_last_updated - -pulp_type - -rate_limit - -sock_connect_timeout - -sock_read_timeout - -tls_validation - -total_timeout - -url - -username - ca_cert - client_cert - client_key - connect_timeout - download_concurrency - headers - max_retries - name - password - pk - policy - proxy_password - proxy_url - proxy_username - pulp_created - pulp_id - pulp_labels - pulp_last_updated - pulp_type - rate_limit - sock_connect_timeout - sock_read_timeout - tls_validation - total_timeout - url - username description: 'Ordering * `pulp_id` - Pulp id * `-pulp_id` - Pulp id (descending) * `pulp_created` - Pulp created * `-pulp_created` - Pulp created (descending) * `pulp_last_updated` - Pulp last updated * `-pulp_last_updated` - Pulp last updated (descending) * `pulp_type` - Pulp type * `-pulp_type` - Pulp type (descending) * `name` - Name * `-name` - Name (descending) * `pulp_labels` - Pulp labels * `-pulp_labels` - Pulp labels (descending) * `url` - Url * `-url` - Url (descending) * `ca_cert` - Ca cert * `-ca_cert` - Ca cert (descending) * `client_cert` - Client cert * `-client_cert` - Client cert (descending) * `client_key` - Client key * `-client_key` - Client key (descending) * `tls_validation` - Tls validation * `-tls_validation` - Tls validation (descending) * `username` - Username * `-username` - Username (descending) * `password` - Password * `-password` - Password (descending) * `proxy_url` - Proxy url * `-proxy_url` - Proxy url (descending) * `proxy_username` - Proxy username * `-proxy_username` - Proxy username (descending) * `proxy_password` - Proxy password * `-proxy_password` - Proxy password (descending) * `download_concurrency` - Download concurrency * `-download_concurrency` - Download concurrency (descending) * `max_retries` - Max retries * `-max_retries` - Max retries (descending) * `policy` - Policy * `-policy` - Policy (descending) * `total_timeout` - Total timeout * `-total_timeout` - Total timeout (descending) * `connect_timeout` - Connect timeout * `-connect_timeout` - Connect timeout (descending) * `sock_connect_timeout` - Sock connect timeout * `-sock_connect_timeout` - Sock connect timeout (descending) * `sock_read_timeout` - Sock read timeout * `-sock_read_timeout` - Sock read timeout (descending) * `headers` - Headers * `-headers` - Headers (descending) * `rate_limit` - Rate limit * `-rate_limit` - Rate limit (descending) * `pk` - Pk * `-pk` - Pk (descending)' explode: false style: form - in: query name: pulp_href__in schema: type: array items: type: string description: Multiple values may be separated by commas. explode: false style: form - in: query name: pulp_id__in schema: type: array items: type: string format: uuid description: Multiple values may be separated by commas. explode: false style: form - in: query name: pulp_label_select schema: type: string description: Filter labels by search string - in: query name: pulp_last_updated schema: type: string format: date-time description: Filter results where pulp_last_updated matches value - in: query name: pulp_last_updated__gt schema: type: string format: date-time description: Filter results where pulp_last_updated is greater than value - in: query name: pulp_last_updated__gte schema: type: string format: date-time description: Filter results where pulp_last_updated is greater than or equal to value - in: query name: pulp_last_updated__lt schema: type: string format: date-time description: Filter results where pulp_last_updated is less than value - in: query name: pulp_last_updated__lte schema: type: string format: date-time description: Filter results where pulp_last_updated is less than or equal to value - in: query name: pulp_last_updated__range schema: type: array items: type: string format: date-time description: Filter results where pulp_last_updated is between two comma separated values explode: false style: form - in: query name: q schema: type: string - in: query name: fields schema: type: array items: type: string description: A list of fields to include in the response. - in: query name: exclude_fields schema: type: array items: type: string description: A list of fields to exclude from the response. tags: - 'Remotes: Git' responses: '200': content: application/json: schema: $ref: '#/components/schemas/Paginatedansible.GitRemoteResponseList' description: '' post: operationId: remotes_ansible_git_create description: 'ViewSet for Ansible Remotes. This is a tech preview feature. The functionality may change in the future.' summary: Create a git remote tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/ansible.GitRemote' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/ansible.GitRemote' multipart/form-data: schema: $ref: '#/components/schemas/ansible.GitRemote' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/ansible.GitRemoteResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/: get: operationId: remotes_ansible_git_read description: 'ViewSet for Ansible Remotes. This is a tech preview feature. The functionality may change in the future.' summary: Inspect a git remote parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true - in: query name: fields schema: type: array items: type: string description: A list of fields to include in the response. - in: query name: exclude_fields schema: type: array items: type: string description: A list of fields to exclude from the response. tags: - 'Remotes: Git' responses: '200': content: application/json: schema: $ref: '#/components/schemas/ansible.GitRemoteResponse' description: '' put: operationId: remotes_ansible_git_update description: Trigger an asynchronous update task summary: Update a git remote parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/ansible.GitRemote' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/ansible.GitRemote' multipart/form-data: schema: $ref: '#/components/schemas/ansible.GitRemote' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/AsyncOperationResponse' description: '' patch: operationId: remotes_ansible_git_partial_update description: Trigger an asynchronous partial update task summary: Update a git remote parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/Patchedansible.GitRemote' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/Patchedansible.GitRemote' multipart/form-data: schema: $ref: '#/components/schemas/Patchedansible.GitRemote' required: true responses: '202': content: application/json: schema: $ref: '#/components/schemas/AsyncOperationResponse' description: '' delete: operationId: remotes_ansible_git_delete description: Trigger an asynchronous delete task summary: Delete a git remote parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' responses: '202': content: application/json: schema: $ref: '#/components/schemas/AsyncOperationResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/add_role/: post: operationId: remotes_ansible_git_add_role description: Add a role for this object to users/groups. summary: Add a role parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/NestedRole' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/NestedRole' multipart/form-data: schema: $ref: '#/components/schemas/NestedRole' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/NestedRoleResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/list_roles/: get: operationId: remotes_ansible_git_list_roles description: List roles assigned to this object. summary: List roles parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true - in: query name: fields schema: type: array items: type: string description: A list of fields to include in the response. - in: query name: exclude_fields schema: type: array items: type: string description: A list of fields to exclude from the response. tags: - 'Remotes: Git' responses: '200': content: application/json: schema: $ref: '#/components/schemas/ObjectRolesResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/my_permissions/: get: operationId: remotes_ansible_git_my_permissions description: List permissions available to the current user on this object. summary: List user permissions parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true - in: query name: fields schema: type: array items: type: string description: A list of fields to include in the response. - in: query name: exclude_fields schema: type: array items: type: string description: A list of fields to exclude from the response. tags: - 'Remotes: Git' responses: '200': content: application/json: schema: $ref: '#/components/schemas/MyPermissionsResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/remove_role/: post: operationId: remotes_ansible_git_remove_role description: Remove a role for this object from users/groups. summary: Remove a role parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/NestedRole' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/NestedRole' multipart/form-data: schema: $ref: '#/components/schemas/NestedRole' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/NestedRoleResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/set_label/: post: operationId: remotes_ansible_git_set_label description: Set a single pulp_label on the object to a specific value or null. summary: Set a label parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/SetLabel' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/SetLabel' multipart/form-data: schema: $ref: '#/components/schemas/SetLabel' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/SetLabelResponse' description: '' /api/automation-hub/pulp/api/v3/remotes/ansible/git/{pulp_id}/unset_label/: post: operationId: remotes_ansible_git_unset_label description: Unset a single pulp_label on the object. summary: Unset a label parameters: - in: path name: pulp_id schema: type: string format: uuid description: A UUID string identifying this git remote. required: true tags: - 'Remotes: Git' requestBody: content: application/json: schema: $ref: '#/components/schemas/UnsetLabel' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/UnsetLabel' multipart/form-data: schema: $ref: '#/components/schemas/UnsetLabel' required: true responses: '201': content: application/json: schema: $ref: '#/components/schemas/UnsetLabelResponse' description: '' components: schemas: ObjectRolesResponse: type: object properties: roles: type: array items: $ref: '#/components/schemas/NestedRoleResponse' required: - roles SetLabel: type: object description: Serializer for synchronously setting a label. properties: key: type: string minLength: 1 pattern: ^[-a-zA-Z0-9_]+$ value: type: - string - 'null' required: - key - value ansible.GitRemoteResponse: type: object description: A serializer for Git Collection Remotes. properties: max_retries: type: - integer - 'null' format: int64 description: Maximum number of retry attempts after a download failure. If not set then the default value (3) will be used. total_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.total (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. pulp_last_updated: type: string format: date-time readOnly: true description: Timestamp of the most recent update of the remote. tls_validation: type: boolean description: If True, TLS peer validation must be performed. url: type: string description: The URL of an external content source. name: type: string description: A unique name for this remote. pulp_href: type: string format: uri readOnly: true sock_connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. headers: type: array items: type: object description: Headers for aiohttp.Clientsession connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. proxy_url: type: - string - 'null' description: 'The proxy URL. Format: scheme://host:port' download_concurrency: type: - integer - 'null' format: int64 description: Total number of simultaneous connections. If not set then the default value will be used. minimum: 1 pulp_created: type: string format: date-time readOnly: true description: Timestamp of creation. sock_read_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_read (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. pulp_labels: type: object additionalProperties: type: - string - 'null' hidden_fields: type: array items: type: object properties: name: type: string is_set: type: boolean required: - is_set - name readOnly: true description: List of hidden (write only) fields client_cert: type: - string - 'null' description: A PEM encoded client certificate used for authentication. ca_cert: type: - string - 'null' description: A PEM encoded CA certificate used to validate the server certificate presented by the remote server. rate_limit: type: - integer - 'null' format: int64 description: Limits requests per second for each concurrent downloader metadata_only: type: boolean description: If True, only metadata about the content will be stored in Pulp. Clients will retrieve content from the remote URL. git_ref: type: string description: 'A git ref. e.g.: branch, tag, or commit sha.' required: - name - url MyPermissionsResponse: type: object properties: permissions: type: array items: type: string required: - permissions NestedRole: type: object description: 'Serializer to add/remove object roles to/from users/groups. This is used in conjunction with ``pulpcore.app.viewsets.base.RolesMixin`` and requires the underlying object to be passed as ``content_object`` in the context.' properties: users: type: array items: type: string minLength: 1 description: Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only. default: [] groups: type: array items: type: string minLength: 1 default: [] role: type: string minLength: 1 required: - role Paginatedansible.GitRemoteResponseList: type: object required: - count - results properties: count: type: integer example: 123 next: type: - string - 'null' format: uri example: http://api.example.org/accounts/?offset=400&limit=100 previous: type: - string - 'null' format: uri example: http://api.example.org/accounts/?offset=200&limit=100 results: type: array items: $ref: '#/components/schemas/ansible.GitRemoteResponse' UnsetLabel: type: object description: Serializer for synchronously setting a label. properties: key: type: string minLength: 1 pattern: ^[-a-zA-Z0-9_]+$ required: - key Patchedansible.GitRemote: type: object description: A serializer for Git Collection Remotes. properties: proxy_password: type: - string - 'null' writeOnly: true minLength: 1 description: The password to authenticate to the proxy. Extra leading and trailing whitespace characters are not trimmed. client_key: type: - string - 'null' writeOnly: true minLength: 1 description: A PEM encoded private key used for authentication. max_retries: type: - integer - 'null' format: int64 description: Maximum number of retry attempts after a download failure. If not set then the default value (3) will be used. total_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.total (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. tls_validation: type: boolean description: If True, TLS peer validation must be performed. url: type: string minLength: 1 description: The URL of an external content source. name: type: string minLength: 1 description: A unique name for this remote. sock_connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. headers: type: array items: type: object description: Headers for aiohttp.Clientsession connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. proxy_url: type: - string - 'null' minLength: 1 description: 'The proxy URL. Format: scheme://host:port' download_concurrency: type: - integer - 'null' format: int64 description: Total number of simultaneous connections. If not set then the default value will be used. minimum: 1 sock_read_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_read (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. pulp_labels: type: object additionalProperties: type: - string - 'null' client_cert: type: - string - 'null' minLength: 1 description: A PEM encoded client certificate used for authentication. password: type: - string - 'null' writeOnly: true minLength: 1 description: The password to be used for authentication when syncing. Extra leading and trailing whitespace characters are not trimmed. username: type: - string - 'null' writeOnly: true minLength: 1 description: The username to be used for authentication when syncing. proxy_username: type: - string - 'null' writeOnly: true minLength: 1 description: The username to authenticte to the proxy. ca_cert: type: - string - 'null' minLength: 1 description: A PEM encoded CA certificate used to validate the server certificate presented by the remote server. rate_limit: type: - integer - 'null' format: int64 description: Limits requests per second for each concurrent downloader metadata_only: type: boolean description: If True, only metadata about the content will be stored in Pulp. Clients will retrieve content from the remote URL. git_ref: type: string minLength: 1 description: 'A git ref. e.g.: branch, tag, or commit sha.' NestedRoleResponse: type: object description: 'Serializer to add/remove object roles to/from users/groups. This is used in conjunction with ``pulpcore.app.viewsets.base.RolesMixin`` and requires the underlying object to be passed as ``content_object`` in the context.' properties: users: type: array items: type: string description: Required. 150 characters or fewer. Letters, digits and @/./+/-/_ only. default: [] groups: type: array items: type: string default: [] role: type: string required: - role UnsetLabelResponse: type: object description: Serializer for synchronously setting a label. properties: key: type: string pattern: ^[-a-zA-Z0-9_]+$ value: type: string readOnly: true required: - key ansible.GitRemote: type: object description: A serializer for Git Collection Remotes. properties: proxy_password: type: - string - 'null' writeOnly: true minLength: 1 description: The password to authenticate to the proxy. Extra leading and trailing whitespace characters are not trimmed. client_key: type: - string - 'null' writeOnly: true minLength: 1 description: A PEM encoded private key used for authentication. max_retries: type: - integer - 'null' format: int64 description: Maximum number of retry attempts after a download failure. If not set then the default value (3) will be used. total_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.total (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. tls_validation: type: boolean description: If True, TLS peer validation must be performed. url: type: string minLength: 1 description: The URL of an external content source. name: type: string minLength: 1 description: A unique name for this remote. sock_connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. headers: type: array items: type: object description: Headers for aiohttp.Clientsession connect_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.connect (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. proxy_url: type: - string - 'null' minLength: 1 description: 'The proxy URL. Format: scheme://host:port' download_concurrency: type: - integer - 'null' format: int64 description: Total number of simultaneous connections. If not set then the default value will be used. minimum: 1 sock_read_timeout: type: - number - 'null' format: double minimum: 0.0 description: aiohttp.ClientTimeout.sock_read (q.v.) for download-connections. The default is null, which will cause the default from the aiohttp library to be used. pulp_labels: type: object additionalProperties: type: - string - 'null' client_cert: type: - string - 'null' minLength: 1 description: A PEM encoded client certificate used for authentication. password: type: - string - 'null' writeOnly: true minLength: 1 description: The password to be used for authentication when syncing. Extra leading and trailing whitespace characters are not trimmed. username: type: - string - 'null' writeOnly: true minLength: 1 description: The username to be used for authentication when syncing. proxy_username: type: - string - 'null' writeOnly: true minLength: 1 description: The username to authenticte to the proxy. ca_cert: type: - string - 'null' minLength: 1 description: A PEM encoded CA certificate used to validate the server certificate presented by the remote server. rate_limit: type: - integer - 'null' format: int64 description: Limits requests per second for each concurrent downloader metadata_only: type: boolean description: If True, only metadata about the content will be stored in Pulp. Clients will retrieve content from the remote URL. git_ref: type: string minLength: 1 description: 'A git ref. e.g.: branch, tag, or commit sha.' required: - name - url SetLabelResponse: type: object description: Serializer for synchronously setting a label. properties: key: type: string pattern: ^[-a-zA-Z0-9_]+$ value: type: - string - 'null' required: - key - value AsyncOperationResponse: type: object description: Serializer for asynchronous operations. properties: task: type: string format: uri description: The href of the task. required: - task