1. Documentation
×

v1.Binding

Description

Binding ties one object to another; for example, a pod is bound to a node by a scheduler. Deprecated in 1.7, please use the bindings subresource of pods instead.

Object Schema

Expand or mouse-over a field for more information about it.

apiVersion:

kind:

Collapse all
metadata:

Collapse all
  annotations:

    [string]:

  clusterName:

  creationTimestamp:

  deletionGracePeriodSeconds:

  deletionTimestamp:

Collapse all
  finalizers:

  - [string]:

  generateName:

  generation:

Collapse all
  initializers:

Collapse all
    pending:

    - name:

Collapse all
    result:

      apiVersion:

      code:

Collapse all
      details:

Collapse all
        causes:

        - field:

          message:

          reason:

        group:

        kind:

        name:

        retryAfterSeconds:

        uid:

      kind:

      message:

Collapse all
      metadata:

        resourceVersion:

        selfLink:

      reason:

      status:

Collapse all
  labels:

    [string]:

  name:

  namespace:

Collapse all
  ownerReferences:

  - apiVersion:

    blockOwnerDeletion:

    controller:

    kind:

    name:

    uid:

  resourceVersion:

  selfLink:

  uid:

Collapse all
target:

  apiVersion:

  fieldPath:

  kind:

  name:

  namespace:

  resourceVersion:

  uid:

Operations

Create a Binding

Create a Binding

HTTP request

POST /api/v1/bindings HTTP/1.1
Authorization: Bearer $TOKEN
Accept: application/json
Connection: close
Content-Type: application/json'

{
  "kind": "Binding",
  "apiVersion": "v1",
  ...
}

Curl request

$ curl -k \
    -X POST \
    -d @- \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    https://$ENDPOINT/api/v1/bindings <<'EOF'
{
  "kind": "Binding",
  "apiVersion": "v1",
  ...
}
EOF

HTTP body

Parameter Schema

body

v1.Binding

Query parameters

Parameter Description

pretty

If 'true', then the output is pretty printed.

Responses

HTTP Code Schema

200 OK

v1.Binding

401 Unauthorized

Consumes

  • */*

Produces

  • application/json

  • application/yaml

  • application/vnd.kubernetes.protobuf

Create a Binding in a namespace

Create a Binding

HTTP request

POST /api/v1/namespaces/$NAMESPACE/bindings HTTP/1.1
Authorization: Bearer $TOKEN
Accept: application/json
Connection: close
Content-Type: application/json'

{
  "kind": "Binding",
  "apiVersion": "v1",
  ...
}

Curl request

$ curl -k \
    -X POST \
    -d @- \
    -H "Authorization: Bearer $TOKEN" \
    -H 'Accept: application/json' \
    -H 'Content-Type: application/json' \
    https://$ENDPOINT/api/v1/namespaces/$NAMESPACE/bindings <<'EOF'
{
  "kind": "Binding",
  "apiVersion": "v1",
  ...
}
EOF

HTTP body

Parameter Schema

body

v1.Binding

Path parameters

Parameter Description

namespace

object name and auth scope, such as for teams and projects

Query parameters

Parameter Description

pretty

If 'true', then the output is pretty printed.

Responses

HTTP Code Schema

200 OK

v1.Binding

401 Unauthorized

Consumes

  • */*

Produces

  • application/json

  • application/yaml

  • application/vnd.kubernetes.protobuf