diff options
Diffstat (limited to 'docs')
| -rw-r--r-- | docs/api-objects.rst | 1 | ||||
| -rw-r--r-- | docs/gl_objects/pagesdomains.rst | 65 |
2 files changed, 66 insertions, 0 deletions
diff --git a/docs/api-objects.rst b/docs/api-objects.rst index adfe5ff..b18c4ce 100644 --- a/docs/api-objects.rst +++ b/docs/api-objects.rst @@ -22,6 +22,7 @@ API examples gl_objects/mrs gl_objects/namespaces gl_objects/milestones + gl_objects/pagesdomains gl_objects/projects gl_objects/runners gl_objects/settings diff --git a/docs/gl_objects/pagesdomains.rst b/docs/gl_objects/pagesdomains.rst new file mode 100644 index 0000000..d6b39c7 --- /dev/null +++ b/docs/gl_objects/pagesdomains.rst @@ -0,0 +1,65 @@ +############# +Pages domains +############# + +Admin +===== + +References +---------- + +* v4 API: + + + :class:`gitlab.v4.objects.PagesDomain` + + :class:`gitlab.v4.objects.PagesDomainManager` + + :attr:`gitlab.Gitlab.pagesdomains` + +* GitLab API: https://docs.gitlab.com/ce/api/pages_domains.html#list-all-pages-domains + +Examples +-------- + +List all the existing domains (admin only):: + + domains = gl.pagesdomains.list() + +Project pages domain +==================== + +References +---------- + +* v4 API: + + + :class:`gitlab.v4.objects.ProjectPagesDomain` + + :class:`gitlab.v4.objects.ProjectPagesDomainManager` + + :attr:`gitlab.v4.objects.Project.pagesdomains` + +* GitLab API: https://docs.gitlab.com/ce/api/pages_domains.html#list-pages-domains + +Examples +-------- + +List domains for a project:: + + domains = project.pagesdomains.list() + +Get a single domain:: + + domain = project.pagesdomains.get('d1.example.com') + +Create a new domain:: + + domain = project.pagesdomains.create({'domain': 'd2.example.com}) + +Update an existing domain:: + + domain.certificate = open('d2.crt').read() + domain.key = open('d2.key').read() + domain.save() + +Delete an existing domain:: + + domain.delete + # or + project.pagesdomains.delete('d2.example.com') |