forked from pulp/pulp_python
-
Notifications
You must be signed in to change notification settings - Fork 0
Expand file tree
/
Copy pathapi.json
More file actions
1 lines (1 loc) · 28.5 KB
/
Copy pathapi.json
File metadata and controls
1 lines (1 loc) · 28.5 KB
1
{"swagger": "2.0", "info": {"title": "Pulp 3 API", "logo": {"url": "https://pulp.plan.io/attachments/download/517478/pulp_logo_word_rectangle.svg"}, "version": "v3"}, "host": "localhost:24817", "schemes": ["http"], "basePath": "/", "consumes": ["application/json"], "produces": ["application/json"], "securityDefinitions": {"Basic": {"type": "basic"}}, "security": [{"Basic": []}], "paths": {"/pulp/api/v3/content/python/packages/": {"get": {"operationId": "content_python_packages_list", "summary": "List python package contents", "description": "<!-- User-facing documentation, rendered as html-->\nPythonPackageContent represents each individually installable Python package. In the Python\necosystem, this is called a <i>Python Distribution</i>, sometimes (ambiguously) refered to as a\npackage. In Pulp Python, we refer to it as <i>PythonPackageContent</i>. Each\nPythonPackageContent corresponds to a single filename, for example\n`pulpcore-3.0.0rc1-py3-none-any.whl` or `pulpcore-3.0.0rc1.tar.gz`.", "parameters": [{"name": "name", "in": "query", "description": "Filter results where name matches value", "required": false, "type": "string"}, {"name": "name__in", "in": "query", "description": "Filter results where name is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "author", "in": "query", "description": "Filter results where author matches value", "required": false, "type": "string"}, {"name": "author__in", "in": "query", "description": "Filter results where author is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "packagetype", "in": "query", "description": "Filter results where packagetype matches value", "required": false, "type": "string"}, {"name": "packagetype__in", "in": "query", "description": "Filter results where packagetype is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "filename", "in": "query", "description": "Filter results where filename matches value", "required": false, "type": "string"}, {"name": "filename__in", "in": "query", "description": "Filter results where filename is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "filename__contains", "in": "query", "description": "Filter results where filename contains value", "required": false, "type": "string"}, {"name": "keywords__in", "in": "query", "description": "Filter results where keywords is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "keywords__contains", "in": "query", "description": "Filter results where keywords contains value", "required": false, "type": "string"}, {"name": "repository_version", "in": "query", "description": "Repository Version referenced by HREF", "required": false, "type": "string"}, {"name": "repository_version_added", "in": "query", "description": "Repository Version referenced by HREF", "required": false, "type": "string"}, {"name": "repository_version_removed", "in": "query", "description": "Repository Version referenced by HREF", "required": false, "type": "string"}, {"name": "page", "in": "query", "description": "A page number within the paginated result set.", "required": false, "type": "integer"}, {"name": "page_size", "in": "query", "description": "Number of results to return per page.", "required": false, "type": "integer"}], "responses": {"200": {"description": "", "schema": {"required": ["count", "results"], "type": "object", "properties": {"count": {"type": "integer"}, "next": {"type": "string", "format": "uri", "x-nullable": true}, "previous": {"type": "string", "format": "uri", "x-nullable": true}, "results": {"type": "array", "items": {"$ref": "#/definitions/PythonPackageContent"}}}}}}, "tags": ["content"]}, "post": {"operationId": "content_python_packages_create", "summary": "Create a python package content", "description": "<!-- User-facing documentation, rendered as html-->\nThis endpoint is part of the <a href=\"workflows/upload.html\">Upload workflow.</a> Create\na PythonPackageContent here by specifying an uploaded Artifact. `pulp-python` will inspect\nparse the metadata directly from the file.", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonPackageContent"}}], "responses": {"201": {"description": "", "schema": {"$ref": "#/definitions/PythonPackageContent"}}}, "tags": ["content"]}, "parameters": []}, "{python_package_content_href}": {"get": {"operationId": "content_python_packages_read", "summary": "Inspect a python package content", "description": "<!-- User-facing documentation, rendered as html-->\nPythonPackageContent represents each individually installable Python package. In the Python\necosystem, this is called a <i>Python Distribution</i>, sometimes (ambiguously) refered to as a\npackage. In Pulp Python, we refer to it as <i>PythonPackageContent</i>. Each\nPythonPackageContent corresponds to a single filename, for example\n`pulpcore-3.0.0rc1-py3-none-any.whl` or `pulpcore-3.0.0rc1.tar.gz`.", "parameters": [], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/PythonPackageContent"}}}, "tags": ["content"]}, "parameters": [{"name": "python_package_content_href", "in": "path", "description": "URI of Python Package Content. e.g.: /pulp/api/v3/content/python/packages/1/", "required": true, "type": "string"}]}, "/pulp/api/v3/distributions/python/pypi/": {"get": {"operationId": "distributions_python_pypi_list", "summary": "List python distributions", "description": "<!-- User-facing documentation, rendered as html-->\nPulp Python Distributions are used to distribute\n<a href=\"../restapi.html#tag/publications\">Python Publications.</a> <b> Pulp Python\nDistributions should not be confused with \"Python Distribution\" as defined by the Python\ncommunity.</b> In Pulp usage, Python content is refered to as <a\nhref=\"../restapi.html#tag/content\">Python Package Content.</a>", "parameters": [{"name": "name", "in": "query", "description": "", "required": false, "type": "string"}, {"name": "name__in", "in": "query", "description": "Filter results where name is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "base_path", "in": "query", "description": "", "required": false, "type": "string"}, {"name": "base_path__contains", "in": "query", "description": "Filter results where base_path contains value", "required": false, "type": "string"}, {"name": "base_path__icontains", "in": "query", "description": "Filter results where base_path contains value", "required": false, "type": "string"}, {"name": "base_path__in", "in": "query", "description": "Filter results where base_path is in a comma-separated list of values", "required": false, "type": "string"}, {"name": "page", "in": "query", "description": "A page number within the paginated result set.", "required": false, "type": "integer"}, {"name": "page_size", "in": "query", "description": "Number of results to return per page.", "required": false, "type": "integer"}], "responses": {"200": {"description": "", "schema": {"required": ["count", "results"], "type": "object", "properties": {"count": {"type": "integer"}, "next": {"type": "string", "format": "uri", "x-nullable": true}, "previous": {"type": "string", "format": "uri", "x-nullable": true}, "results": {"type": "array", "items": {"$ref": "#/definitions/PythonDistribution"}}}}}}, "tags": ["distributions"]}, "post": {"operationId": "distributions_python_pypi_create", "summary": "Create a python distribution", "description": "Trigger an asynchronous create task", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonDistribution"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["distributions"]}, "parameters": []}, "{python_distribution_href}": {"get": {"operationId": "distributions_python_pypi_read", "summary": "Inspect a python distribution", "description": "<!-- User-facing documentation, rendered as html-->\nPulp Python Distributions are used to distribute\n<a href=\"../restapi.html#tag/publications\">Python Publications.</a> <b> Pulp Python\nDistributions should not be confused with \"Python Distribution\" as defined by the Python\ncommunity.</b> In Pulp usage, Python content is refered to as <a\nhref=\"../restapi.html#tag/content\">Python Package Content.</a>", "parameters": [], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/PythonDistribution"}}}, "tags": ["distributions"]}, "put": {"operationId": "distributions_python_pypi_update", "summary": "Update a python distribution", "description": "Trigger an asynchronous update task", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonDistribution"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["distributions"]}, "patch": {"operationId": "distributions_python_pypi_partial_update", "summary": "Partially update a python distribution", "description": "Trigger an asynchronous partial update task", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonDistribution"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["distributions"]}, "delete": {"operationId": "distributions_python_pypi_delete", "summary": "Delete a python distribution", "description": "Trigger an asynchronous delete task", "parameters": [], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["distributions"]}, "parameters": [{"name": "python_distribution_href", "in": "path", "description": "URI of Python Distribution. e.g.: /pulp/api/v3/distributions/python/pypi/1/", "required": true, "type": "string"}]}, "/pulp/api/v3/publications/python/pypi/": {"get": {"operationId": "publications_python_pypi_list", "summary": "List python publications", "description": "<!-- User-facing documentation, rendered as html-->\nPython Publications refer to the Python Package content in a repository version, and include\nmetadata about that content.", "parameters": [{"name": "ordering", "in": "query", "description": "Which field to use when ordering the results.", "required": false, "type": "string"}, {"name": "page", "in": "query", "description": "A page number within the paginated result set.", "required": false, "type": "integer"}, {"name": "page_size", "in": "query", "description": "Number of results to return per page.", "required": false, "type": "integer"}], "responses": {"200": {"description": "", "schema": {"required": ["count", "results"], "type": "object", "properties": {"count": {"type": "integer"}, "next": {"type": "string", "format": "uri", "x-nullable": true}, "previous": {"type": "string", "format": "uri", "x-nullable": true}, "results": {"type": "array", "items": {"$ref": "#/definitions/PythonPublication"}}}}}}, "tags": ["publications"]}, "post": {"operationId": "publications_python_pypi_create", "summary": "Create a python publication", "description": "Trigger an asynchronous task to publish python content.", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonPublication"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["publications"]}, "parameters": []}, "{python_publication_href}": {"get": {"operationId": "publications_python_pypi_read", "summary": "Inspect a python publication", "description": "<!-- User-facing documentation, rendered as html-->\nPython Publications refer to the Python Package content in a repository version, and include\nmetadata about that content.", "parameters": [], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/PythonPublication"}}}, "tags": ["publications"]}, "delete": {"operationId": "publications_python_pypi_delete", "summary": "Delete a python publication", "description": "<!-- User-facing documentation, rendered as html-->\nPython Publications refer to the Python Package content in a repository version, and include\nmetadata about that content.", "parameters": [], "responses": {"204": {"description": ""}}, "tags": ["publications"]}, "parameters": [{"name": "python_publication_href", "in": "path", "description": "URI of Python Publication. e.g.: /pulp/api/v3/publications/python/pypi/1/", "required": true, "type": "string"}]}, "/pulp/api/v3/remotes/python/python/": {"get": {"operationId": "remotes_python_python_list", "summary": "List python remotes", "description": "<!-- User-facing documentation, rendered as html-->\nPython Remotes are representations of an <b>external repository</b> of Python content, eg.\nPyPI. Fields include upstream repository config. Python Remotes are also used to `sync` from\nupstream repositories, and contains sync settings.", "parameters": [{"name": "name", "in": "query", "description": "", "required": false, "type": "string"}, {"name": "_last_updated", "in": "query", "description": "ISO 8601 formatted dates are supported", "required": false, "type": "string"}, {"name": "page", "in": "query", "description": "A page number within the paginated result set.", "required": false, "type": "integer"}, {"name": "page_size", "in": "query", "description": "Number of results to return per page.", "required": false, "type": "integer"}], "responses": {"200": {"description": "", "schema": {"required": ["count", "results"], "type": "object", "properties": {"count": {"type": "integer"}, "next": {"type": "string", "format": "uri", "x-nullable": true}, "previous": {"type": "string", "format": "uri", "x-nullable": true}, "results": {"type": "array", "items": {"$ref": "#/definitions/PythonRemote"}}}}}}, "tags": ["remotes"]}, "post": {"operationId": "remotes_python_python_create", "summary": "Create a python remote", "description": "<!-- User-facing documentation, rendered as html-->\nPython Remotes are representations of an <b>external repository</b> of Python content, eg.\nPyPI. Fields include upstream repository config. Python Remotes are also used to `sync` from\nupstream repositories, and contains sync settings.", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonRemote"}}], "responses": {"201": {"description": "", "schema": {"$ref": "#/definitions/PythonRemote"}}}, "tags": ["remotes"]}, "parameters": []}, "{python_remote_href}": {"get": {"operationId": "remotes_python_python_read", "summary": "Inspect a python remote", "description": "<!-- User-facing documentation, rendered as html-->\nPython Remotes are representations of an <b>external repository</b> of Python content, eg.\nPyPI. Fields include upstream repository config. Python Remotes are also used to `sync` from\nupstream repositories, and contains sync settings.", "parameters": [], "responses": {"200": {"description": "", "schema": {"$ref": "#/definitions/PythonRemote"}}}, "tags": ["remotes"]}, "put": {"operationId": "remotes_python_python_update", "summary": "Update a python remote", "description": "Trigger an asynchronous update task", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonRemote"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["remotes"]}, "patch": {"operationId": "remotes_python_python_partial_update", "summary": "Partially update a python remote", "description": "Trigger an asynchronous partial update task", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/PythonRemote"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["remotes"]}, "delete": {"operationId": "remotes_python_python_delete", "summary": "Delete a python remote", "description": "Trigger an asynchronous delete task", "parameters": [], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["remotes"]}, "parameters": [{"name": "python_remote_href", "in": "path", "description": "URI of Python Remote. e.g.: /pulp/api/v3/remotes/python/python/1/", "required": true, "type": "string"}]}, "{python_remote_href}sync/": {"post": {"operationId": "remotes_python_python_sync", "description": "<!-- User-facing documentation, rendered as html-->\nTrigger an asynchronous task to sync python content. The sync task will retrieve Python\ncontent from the specified `Remote` and \" update the specified `Respository`, creating a\nnew `RepositoryVersion`.", "parameters": [{"name": "data", "in": "body", "required": true, "schema": {"$ref": "#/definitions/RepositorySyncURL"}}], "responses": {"202": {"description": "", "schema": {"$ref": "#/definitions/AsyncOperationResponse"}}}, "tags": ["remotes"]}, "parameters": [{"name": "python_remote_href", "in": "path", "description": "URI of Python Remote. e.g.: /pulp/api/v3/remotes/python/python/1/", "required": true, "type": "string"}]}}, "definitions": {"Classifier": {"required": ["name"], "type": "object", "properties": {"name": {"title": "Name", "description": "A string giving a single classification value for a Python package.", "type": "string", "minLength": 1}}}, "PythonPackageContent": {"required": ["_artifact", "_relative_path", "filename", "packagetype", "name", "version", "metadata_version"], "type": "object", "properties": {"_href": {"title": " href", "type": "string", "format": "uri", "readOnly": true}, "_created": {"title": " created", "description": "Timestamp of creation.", "type": "string", "format": "date-time", "readOnly": true}, "_type": {"title": " type", "type": "string", "readOnly": true, "minLength": 1}, "_artifact": {"title": " artifact", "description": "Artifact file representing the physical content", "type": "string", "format": "uri"}, "_relative_path": {"title": " relative path", "description": "Path where the artifact is located relative to distributions base_path", "type": "string", "minLength": 1}, "filename": {"title": "Filename", "description": "The name of the distribution package, usually of the format: {distribution}-{version}(-{build tag})?-{python tag}-{abi tag}-{platform tag}.{packagetype}", "type": "string", "minLength": 1}, "packagetype": {"title": "Packagetype", "description": "The type of the distribution package (e.g. sdist, bdist_wheel, bdist_egg, etc)", "type": "string", "minLength": 1}, "name": {"title": "Name", "description": "The name of the python project.", "type": "string", "minLength": 1}, "version": {"title": "Version", "description": "The packages version number.", "type": "string", "minLength": 1}, "metadata_version": {"title": "Metadata version", "description": "Version of the file format", "type": "string", "minLength": 1}, "summary": {"title": "Summary", "description": "A one-line summary of what the package does.", "type": "string"}, "description": {"title": "Description", "description": "A longer description of the package that can run to several paragraphs.", "type": "string"}, "keywords": {"title": "Keywords", "description": "Additional keywords to be used to assist searching for the package in a larger catalog.", "type": "string"}, "home_page": {"title": "Home page", "description": "The URL for the package's home page.", "type": "string"}, "download_url": {"title": "Download url", "description": "Legacy field denoting the URL from which this package can be downloaded.", "type": "string"}, "author": {"title": "Author", "description": "Text containing the author's name. Contact information can also be added, separated with newlines.", "type": "string"}, "author_email": {"title": "Author email", "description": "The author's e-mail address. ", "type": "string"}, "maintainer": {"title": "Maintainer", "description": "The maintainer's name at a minimum; additional contact information may be provided.", "type": "string"}, "maintainer_email": {"title": "Maintainer email", "description": "The maintainer's e-mail address.", "type": "string"}, "license": {"title": "License", "description": "Text indicating the license covering the distribution", "type": "string"}, "requires_python": {"title": "Requires python", "description": "The Python version(s) that the distribution is guaranteed to be compatible with.", "type": "string"}, "project_url": {"title": "Project url", "description": "A browsable URL for the project and a label for it, separated by a comma.", "type": "string"}, "platform": {"title": "Platform", "description": "A comma-separated list of platform specifications, summarizing the operating systems supported by the package.", "type": "string"}, "supported_platform": {"title": "Supported platform", "description": "Field to specify the OS and CPU for which the binary package was compiled. ", "type": "string"}, "requires_dist": {"title": "Requires dist", "description": "A JSON list containing names of some other distutils project required by this distribution.", "type": "string", "default": "[]", "minLength": 1}, "provides_dist": {"title": "Provides dist", "description": "A JSON list containing names of a Distutils project which is contained within this distribution.", "type": "string", "default": "[]", "minLength": 1}, "obsoletes_dist": {"title": "Obsoletes dist", "description": "A JSON list containing names of a distutils project's distribution which this distribution renders obsolete, meaning that the two projects should not be installed at the same time.", "type": "string", "default": "[]", "minLength": 1}, "requires_external": {"title": "Requires external", "description": "A JSON list containing some dependency in the system that the distribution is to be used.", "type": "string", "default": "[]", "minLength": 1}, "classifiers": {"type": "array", "items": {"$ref": "#/definitions/Classifier"}}}}, "PythonDistribution": {"required": ["base_path", "name"], "type": "object", "properties": {"_href": {"title": " href", "type": "string", "format": "uri", "readOnly": true}, "_created": {"title": " created", "description": "Timestamp of creation.", "type": "string", "format": "date-time", "readOnly": true}, "base_path": {"title": "Base path", "description": "The base (relative) path component of the published url. Avoid paths that overlap with other distribution base paths (e.g. \"foo\" and \"foo/bar\")", "type": "string", "maxLength": 255, "minLength": 1}, "base_url": {"title": "Base url", "description": "The URL for accessing the publication as defined by this distribution.", "type": "string", "readOnly": true, "minLength": 1}, "content_guard": {"title": "Content guard", "description": "An optional content-guard.", "type": "string", "format": "uri", "x-nullable": true}, "name": {"title": "Name", "description": "A unique name. Ex, `rawhide` and `stable`.", "type": "string", "maxLength": 255, "minLength": 1}, "remote": {"title": "Remote", "description": "Remote that can be used to fetch content when using pull-through caching.", "type": "string", "format": "uri", "x-nullable": true}, "publication": {"title": "Publication", "description": "Publication to be served", "type": "string", "format": "uri", "x-nullable": true}}}, "AsyncOperationResponse": {"required": ["task"], "type": "object", "properties": {"task": {"title": "Task", "description": "The href of the task.", "type": "string", "format": "uri"}}}, "PythonPublication": {"type": "object", "properties": {"_href": {"title": " href", "type": "string", "format": "uri", "readOnly": true}, "_created": {"title": " created", "description": "Timestamp of creation.", "type": "string", "format": "date-time", "readOnly": true}, "_type": {"title": " type", "type": "string", "readOnly": true, "minLength": 1}, "publisher": {"title": "Publisher", "type": "string", "format": "uri", "x-nullable": true}, "repository_version": {"title": "Repository version", "type": "string", "format": "uri"}, "repository": {"title": "Repository", "description": "A URI of the repository to be published.", "type": "string", "format": "uri"}, "distributions": {"description": "This publication is currently being hosted as configured by these distributions.", "type": "array", "items": {"description": "This publication is currently being hosted as configured by these distributions.", "type": "string", "format": "uri"}, "readOnly": true, "uniqueItems": true}}}, "ProjectSpecifier": {"description": "AKA \"Whitelist\". A list of dictionaries, expand for more information.\n Example:\n\n [{\"name\": \"django\", \"version_specifier\":\"~=2.0\"}]\n ", "required": ["name"], "type": "object", "properties": {"name": {"title": "Name", "description": "A python project name.", "type": "string", "minLength": 1}, "version_specifier": {"title": "Version specifier", "description": "A version specifier accepts standard python versions syntax: `>=`, `<=`, `==`, `~=`, `>`, `<`, `!` and can be used in conjunction with other specifiers i.e. `>1`,`<=3`,`!=3.0.2`. Note that the specifiers treat pre-released versions as `<` released versions, so 3.0.0a1 < 3.0.0. Not setting the version_specifier will sync all the pre-released and released versions.", "type": "string"}}}, "PythonRemote": {"required": ["name", "url"], "type": "object", "properties": {"_href": {"title": " href", "type": "string", "format": "uri", "readOnly": true}, "_created": {"title": " created", "description": "Timestamp of creation.", "type": "string", "format": "date-time", "readOnly": true}, "_type": {"title": " type", "type": "string", "readOnly": true, "minLength": 1}, "name": {"title": "Name", "description": "A unique name for this remote.", "type": "string", "minLength": 1}, "url": {"title": "Url", "description": "The URL of an external content source.", "type": "string", "minLength": 1}, "validate": {"title": "Validate", "description": "If True, the plugin will validate imported artifacts.", "type": "boolean"}, "ssl_ca_certificate": {"title": "Ssl ca certificate", "description": "A PEM encoded CA certificate used to validate the server certificate presented by the remote server. Returns SHA256 sum on GET.", "type": "string"}, "ssl_client_certificate": {"title": "Ssl client certificate", "description": "A PEM encoded client certificate used for authentication. Returns SHA256 sum on GET.", "type": "string"}, "ssl_client_key": {"title": "Ssl client key", "description": "A PEM encoded private key used for authentication. Returns SHA256 sum on GET.", "type": "string"}, "ssl_validation": {"title": "Ssl validation", "description": "If True, SSL peer validation must be performed.", "type": "boolean"}, "proxy_url": {"title": "Proxy url", "description": "The proxy URL. Format: scheme://user:password@host:port", "type": "string"}, "username": {"title": "Username", "description": "The username to be used for authentication when syncing.", "type": "string"}, "password": {"title": "Password", "description": "The password to be used for authentication when syncing.", "type": "string"}, "_last_updated": {"title": " last updated", "description": "Timestamp of the most recent update of the remote.", "type": "string", "format": "date-time", "readOnly": true}, "download_concurrency": {"title": "Download concurrency", "description": "Total number of simultaneous connections.", "type": "integer", "minimum": 1}, "policy": {"title": "Policy", "description": "The policy to use when downloading content. The possible values include: 'immediate', 'on_demand', and 'cache_only'. 'immediate' is the default.", "type": "string", "enum": ["immediate", "on_demand", "streamed"], "default": "immediate"}, "includes": {"description": "AKA \"Whitelist\". A list of dictionaries, expand for more information.\n Example:\n\n [{\"name\": \"django\", \"version_specifier\":\"~=2.0\"}]\n ", "type": "array", "items": {"$ref": "#/definitions/ProjectSpecifier"}}, "excludes": {"description": "\"AKA \"Blacklist\". A list of dictionaries, expand for more information.\n Example:\n\n [{\"name\": \"django\", \"version_specifier\":\"~=2.0\"}]\n ", "type": "array", "items": {"$ref": "#/definitions/ProjectSpecifier"}}, "prereleases": {"title": "Prereleases", "description": "Whether or not to include pre-release packages in the sync.", "type": "boolean"}}}, "RepositorySyncURL": {"required": ["repository"], "type": "object", "properties": {"repository": {"title": "Repository", "description": "A URI of the repository to be synchronized.", "type": "string", "format": "uri"}, "mirror": {"title": "Mirror", "description": "If ``True``, synchronization will remove all content that is not present in the remote repository. If ``False``, sync will be additive only.", "type": "boolean", "default": false}}}}, "tags": [{"name": "content", "x-displayName": "Content"}, {"name": "distributions", "x-displayName": "Distributions"}, {"name": "publications", "x-displayName": "Publications"}, {"name": "remotes", "x-displayName": "Remotes"}]}