summaryrefslogtreecommitdiffstats
path: root/third_party/python/taskcluster/taskcluster/generated/aio/secrets.py
blob: f8ccdc2366b92d63549bfe511f60b9fa2dba09f7 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# coding=utf-8
#####################################################
# THIS FILE IS AUTOMATICALLY GENERATED. DO NOT EDIT #
#####################################################
# noqa: E128,E201
from ...aio.asyncclient import AsyncBaseClient
from ...aio.asyncclient import createApiClient
from ...aio.asyncclient import config
from ...aio.asyncclient import createTemporaryCredentials
from ...aio.asyncclient import createSession
_defaultConfig = config


class Secrets(AsyncBaseClient):
    """
    The secrets service provides a simple key/value store for small bits of secret
    data.  Access is limited by scopes, so values can be considered secret from
    those who do not have the relevant scopes.

    Secrets also have an expiration date, and once a secret has expired it can no
    longer be read.  This is useful for short-term secrets such as a temporary
    service credential or a one-time signing key.
    """

    classOptions = {
    }
    serviceName = 'secrets'
    apiVersion = 'v1'

    async def ping(self, *args, **kwargs):
        """
        Ping Server

        Respond without doing anything.
        This endpoint is used to check that the service is up.

        This method is ``stable``
        """

        return await self._makeApiCall(self.funcinfo["ping"], *args, **kwargs)

    async def set(self, *args, **kwargs):
        """
        Set Secret

        Set the secret associated with some key.  If the secret already exists, it is
        updated instead.

        This method is ``stable``
        """

        return await self._makeApiCall(self.funcinfo["set"], *args, **kwargs)

    async def remove(self, *args, **kwargs):
        """
        Delete Secret

        Delete the secret associated with some key. It will succeed whether or not the secret exists

        This method is ``stable``
        """

        return await self._makeApiCall(self.funcinfo["remove"], *args, **kwargs)

    async def get(self, *args, **kwargs):
        """
        Read Secret

        Read the secret associated with some key.  If the secret has recently
        expired, the response code 410 is returned.  If the caller lacks the
        scope necessary to get the secret, the call will fail with a 403 code
        regardless of whether the secret exists.

        This method is ``stable``
        """

        return await self._makeApiCall(self.funcinfo["get"], *args, **kwargs)

    async def list(self, *args, **kwargs):
        """
        List Secrets

        List the names of all secrets.

        By default this end-point will try to return up to 1000 secret names in one
        request. But it **may return less**, even if more tasks are available.
        It may also return a `continuationToken` even though there are no more
        results. However, you can only be sure to have seen all results if you
        keep calling `listTaskGroup` with the last `continuationToken` until you
        get a result without a `continuationToken`.

        If you are not interested in listing all the members at once, you may
        use the query-string option `limit` to return fewer.

        This method is ``stable``
        """

        return await self._makeApiCall(self.funcinfo["list"], *args, **kwargs)

    funcinfo = {
        "get": {
            'args': ['name'],
            'method': 'get',
            'name': 'get',
            'output': 'v1/secret.json#',
            'route': '/secret/<name>',
            'stability': 'stable',
        },
        "list": {
            'args': [],
            'method': 'get',
            'name': 'list',
            'output': 'v1/secret-list.json#',
            'query': ['continuationToken', 'limit'],
            'route': '/secrets',
            'stability': 'stable',
        },
        "ping": {
            'args': [],
            'method': 'get',
            'name': 'ping',
            'route': '/ping',
            'stability': 'stable',
        },
        "remove": {
            'args': ['name'],
            'method': 'delete',
            'name': 'remove',
            'route': '/secret/<name>',
            'stability': 'stable',
        },
        "set": {
            'args': ['name'],
            'input': 'v1/secret.json#',
            'method': 'put',
            'name': 'set',
            'route': '/secret/<name>',
            'stability': 'stable',
        },
    }


__all__ = ['createTemporaryCredentials', 'config', '_defaultConfig', 'createApiClient', 'createSession', 'Secrets']