Returns permissions that a caller has on the specified resource. If the
resource does not exist, this will return an empty set of permissions,
not a `NOT_FOUND` error. Note: This operation is designed to be used for
building permission-aware UIs and command-line tools, not for
authorization checking. This operation may "fail open" without
warning.

## Arguments

| Parameters ||
|---|---|
| `resource` | `string` REQUIRED: The resource for which the policy detail is being requested. See the operation documentation for the appropriate value for this field. |
| `body` | `object (https://docs.cloud.google.com/workflows/docs/reference/googleapis/pubsub/v1/Overview#TestIamPermissionsRequest)` Required. |

## Raised exceptions

| Exceptions ||
|---|---|
| `ConnectionError` | In case of a network problem (such as DNS failure or refused connection). |
| `HttpError` | If the response status is \>= 400 (excluding 429 and 503). |
| `TimeoutError` | If a long-running operation takes longer to finish than the specified timeout limit. |
| `TypeError` | If an operation or function receives an argument of the wrong type. |
| `ValueError` | If an operation or function receives an argument of the right type but an inappropriate value. For example, a negative timeout. |

## Response

If successful, the response contains an instance of [`TestIamPermissionsResponse`](https://docs.cloud.google.com/workflows/docs/reference/googleapis/pubsub/v1/Overview#TestIamPermissionsResponse).

## Subworkflow snippet

Some fields might be optional or required.
To identify required fields, refer to the [API documentation](https://cloud.google.com/pubsub/docs/reference/rest/v1/projects.topics/testIamPermissions).

### YAML

```yaml
- testIamPermissions:
    call: googleapis.pubsub.v1.projects.topics.testIamPermissions
    args:
        resource: ...
        body:
            permissions: ...
    result: testIamPermissionsResult
```

### JSON

```json
[
  {
    "testIamPermissions": {
      "call": "googleapis.pubsub.v1.projects.topics.testIamPermissions",
      "args": {
        "resource": "...",
        "body": {
          "permissions": "..."
        }
      },
      "result": "testIamPermissionsResult"
    }
  }
]
```