v2alpha1.CronJob

    You are viewing documentation for a release that is no longer supported. The latest supported version of version 3 is [3.11]. For the most recent version 4, see

    CronJob represents the configuration of a single cron job.

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

    Create a CronJob

    HTTP request

    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    6. {
    7.   "kind": "CronJob",
    8.   "apiVersion": "batch/v2alpha1",
    9.   ...
    10. }

    Curl request

    1. $ curl -k \
    2.     -X POST \
    3.     -d @- \
    4.     -H "Authorization: Bearer $TOKEN" \
    5.     -H 'Accept: application/json' \
    6.     -H 'Content-Type: application/json' \
    7.     https://$ENDPOINT/apis/batch/v2alpha1/cronjobs <<'EOF'
    8. {
    9.   "kind": "CronJob",
    10.   "apiVersion": "batch/v2alpha1",
    11.   ...
    12. }
    13. EOF

    HTTP body

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Create a CronJob in a namespace

    Create a CronJob

    HTTP request

    1. POST /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    5. Content-Type: application/json'
    7. {
    8.   "kind": "CronJob",
    9.   "apiVersion": "batch/v2alpha1",
    10.   ...
    11. }

    Curl request

    1. $ curl -k \
    2.     -X POST \
    3.     -d @- \
    4.     -H "Authorization: Bearer $TOKEN" \
    5.     -H 'Accept: application/json' \
    6.     -H 'Content-Type: application/json' \
    7.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs <<'EOF'
    8. {
    9.   "kind": "CronJob",
    10.   "apiVersion": "batch/v2alpha1",
    11.   ...
    12. }
    13. EOF

    HTTP body

    ParameterSchema

    body

    v2alpha1.CronJob

    Path parameters

    ParameterDescription

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Get a CronJob in a namespace

    Read the specified CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    exact

    Should the export be exact. Exact export maintains cluster-specific fields like ‘Namespace’.

    export

    Should this value be exported. Export strips fields that a user can not specify.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Get all CronJobs

    List or watch objects of kind CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/cronjobs HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/cronjobs

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    fieldSelector

    A selector to restrict the list of returned objects by their fields. Defaults to everything.

    includeUninitialized

    If true, partially initialized resources are included in the response.

    labelSelector

    A selector to restrict the list of returned objects by their labels. Defaults to everything.

    resourceVersion

    When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

    timeoutSeconds

    Timeout for the list/watch call.

    watch

    Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJobList

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    • application/json;stream=watch

    • application/vnd.kubernetes.protobuf;stream=watch

    Get all CronJobs in a namespace

    List or watch objects of kind CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs HTTP/1.1
    3. Accept: application/json
    4. Connection: close

    Curl request

    Path parameters

    ParameterDescription

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    fieldSelector

    A selector to restrict the list of returned objects by their fields. Defaults to everything.

    includeUninitialized

    If true, partially initialized resources are included in the response.

    labelSelector

    A selector to restrict the list of returned objects by their labels. Defaults to everything.

    resourceVersion

    When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

    timeoutSeconds

    Timeout for the list/watch call.

    watch

    Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJobList

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    • application/json;stream=watch

    • application/vnd.kubernetes.protobuf;stream=watch

    Watch changes to an object of kind CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/watch/namespaces/$NAMESPACE/cronjobs/$NAME HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/watch/namespaces/$NAMESPACE/cronjobs/$NAME

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

    Query parameters

    Responses

    HTTP CodeSchema

    200 OK

    v1.WatchEvent

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    • application/json;stream=watch

    • application/vnd.kubernetes.protobuf;stream=watch

    Watch all CronJobs

    Watch individual changes to a list of CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/watch/cronjobs HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/watch/cronjobs

    Query parameters

    ParameterDescription

    fieldSelector

    A selector to restrict the list of returned objects by their fields. Defaults to everything.

    includeUninitialized

    If true, partially initialized resources are included in the response.

    labelSelector

    A selector to restrict the list of returned objects by their labels. Defaults to everything.

    pretty

    If ‘true’, then the output is pretty printed.

    resourceVersion

    When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

    timeoutSeconds

    Timeout for the list/watch call.

    watch

    Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

    Responses

    HTTP CodeSchema

    200 OK

    v1.WatchEvent

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    • application/json;stream=watch

    • application/vnd.kubernetes.protobuf;stream=watch

    Watch all CronJobs in a namespace

    Watch individual changes to a list of CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/watch/namespaces/$NAMESPACE/cronjobs HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/watch/namespaces/$NAMESPACE/cronjobs

    Path parameters

    ParameterDescription

    namespace

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

    Query parameters

    ParameterDescription

    fieldSelector

    A selector to restrict the list of returned objects by their fields. Defaults to everything.

    includeUninitialized

    If true, partially initialized resources are included in the response.

    labelSelector

    A selector to restrict the list of returned objects by their labels. Defaults to everything.

    pretty

    If ‘true’, then the output is pretty printed.

    resourceVersion

    When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

    timeoutSeconds

    Timeout for the list/watch call.

    watch

    Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

    Responses

    HTTP CodeSchema

    200 OK

    v1.WatchEvent

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    • application/json;stream=watch

    • application/vnd.kubernetes.protobuf;stream=watch

    Update a CronJob in a namespace

    Replace the specified CronJob

    HTTP request

    1. PUT /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Connection: close
    4. Content-Type: application/json'
    6. {
    7.   "kind": "CronJob",
    8.   "apiVersion": "batch/v2alpha1",
    9.   ...
    10. }

    Curl request

    1. $ curl -k \
    2.     -X PUT \
    3.     -d @- \
    4.     -H "Authorization: Bearer $TOKEN" \
    5.     -H 'Accept: application/json' \
    6.     -H 'Content-Type: application/json' \
    7.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME <<'EOF'
    8. {
    9.   "kind": "CronJob",
    10.   "apiVersion": "batch/v2alpha1",
    11.   ...
    12. }
    13. EOF

    HTTP body

    ParameterSchema

    body

    v2alpha1.CronJob

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Patch a CronJob in a namespace

    Partially update the specified CronJob

    HTTP request

    1. PATCH /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    5. Content-Type: application/json-patch+json'
    7. {
    8.   ...
    9. }

    Curl request

    HTTP body

    ParameterSchema

    body

    v1.Patch

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    Consumes

    • application/json-patch+json

    • application/merge-patch+json

    • application/strategic-merge-patch+json

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Delete a CronJob

    HTTP request

    1. DELETE /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    5. Content-Type: application/json'
    7. {
    8.   ...
    9. }

    Curl request

    1. $ curl -k \
    2.     -X DELETE \
    3.     -d @- \
    4.     -H "Authorization: Bearer $TOKEN" \
    5.     -H 'Accept: application/json' \
    6.     -H 'Content-Type: application/json' \
    7.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME <<'EOF'
    8. {
    9.   ...
    10. }
    11. EOF

    HTTP body

    ParameterSchema

    body

    v1.DeleteOptions

    Path parameters

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    gracePeriodSeconds

    The duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the specified type will be used. Defaults to a per object value if not specified. zero means delete immediately.

    orphanDependents

    Deprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the “orphan” finalizer will be added to/removed from the object’s finalizers list. Either this field or PropagationPolicy may be set, but not both.

    propagationPolicy

    Whether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the metadata.finalizers and the resource-specific default policy.

    Responses

    HTTP CodeSchema

    200 OK

    v1.Status

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Delete all CronJobs in a namespace

    Delete collection of CronJob

    HTTP request

    1. DELETE /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -X DELETE \
    3.     -H "Authorization: Bearer $TOKEN" \
    4.     -H 'Accept: application/json' \
    5.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs

    Path parameters

    ParameterDescription

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    fieldSelector

    A selector to restrict the list of returned objects by their fields. Defaults to everything.

    includeUninitialized

    If true, partially initialized resources are included in the response.

    labelSelector

    A selector to restrict the list of returned objects by their labels. Defaults to everything.

    resourceVersion

    When specified with a watch call, shows changes that occur after that particular version of a resource. Defaults to changes from the beginning of history. When specified for list: - if unset, then the result is returned from remote storage based on quorum-read flag; - if it’s 0, then we simply return what we currently have in cache, no guarantee; - if set to non zero, then the result is at least as fresh as given rv.

    timeoutSeconds

    Timeout for the list/watch call.

    watch

    Watch for changes to the described resources and return them as a stream of add, update, and remove notifications. Specify resourceVersion.

    Responses

    HTTP CodeSchema

    200 OK

    v1.Status

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Get status of a CronJob in a namespace

    Read status of the specified CronJob

    HTTP request

    1. GET /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME/status HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close

    Curl request

    1. $ curl -k \
    2.     -H "Authorization: Bearer $TOKEN" \
    3.     -H 'Accept: application/json' \
    4.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME/status

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Update status of a CronJob in a namespace

    Replace status of the specified CronJob

    HTTP request

    1. PUT /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME/status HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    5. Content-Type: application/json'
    7. {
    8.   "kind": "CronJob",
    9.   "apiVersion": "batch/v2alpha1",
    10.   ...
    11. }

    Curl request

    1. $ curl -k \
    2.     -X PUT \
    3.     -d @- \
    4.     -H "Authorization: Bearer $TOKEN" \
    5.     -H 'Accept: application/json' \
    6.     -H 'Content-Type: application/json' \
    7.     https://$ENDPOINT/apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME/status <<'EOF'
    8. {
    9.   "kind": "CronJob",
    10.   "apiVersion": "batch/v2alpha1",
    11.   ...
    12. }
    13. EOF

    HTTP body

    ParameterSchema

    body

    v2alpha1.CronJob

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    HTTP CodeSchema

    200 OK

    v2alpha1.CronJob

    401 Unauthorized

    Consumes

    • */*

    Produces

    • application/json

    • application/yaml

    • application/vnd.kubernetes.protobuf

    Patch status of a CronJob in a namespace

    Partially update status of the specified CronJob

    HTTP request

    1. PATCH /apis/batch/v2alpha1/namespaces/$NAMESPACE/cronjobs/$NAME/status HTTP/1.1
    2. Authorization: Bearer $TOKEN
    3. Accept: application/json
    4. Connection: close
    5. Content-Type: application/json-patch+json'
    7. {
    8.   ...
    9. }

    Curl request

    HTTP body

    ParameterSchema

    body

    v1.Patch

    Path parameters

    ParameterDescription

    name

    name of the CronJob

    namespace

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

    Query parameters

    ParameterDescription

    pretty

    If ‘true’, then the output is pretty printed.

    Responses

    Consumes

    • application/json-patch+json

    • application/merge-patch+json

    • application/strategic-merge-patch+json

    Produces

    • application/json

    • application/yaml